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PREFACE 


This manual assumes the user has read the Atari BASIC — A Self-Teaching 
Guide or some other book on BASIC. This manual is not intended to “teach” 
BASIC. It is a reference guide to the commands, statements, functions, and 
special applications of Atari® BASIC. 

The programs and partial programming examples used in this manual are 
photostats of listings printed on the Atari 820™ Printer. Some of the special sym¬ 
bols in the Atari character set do not appear the same on the printer; e.g., the 
clear screen symbol appears as a “ }”. The examples in the text were 
chosen to illustrate a particular function — not necessarily “good” programming 
techniques. 

Each of the sections contains groups of commands, functions, or statements 
dealing with a particular aspect of Atari BASIC. For instance. Section 9 contains 
all the statements pertaining to Atari’s unique graphics capabilities. The appen¬ 
dices include quick references to terms, error messages, BASIC keywords, 
memory locations, and the ATASCII character set. 

As there is no one specified application for the Atari Personal Computer System, 
this manual is directed at general applications and the general user. Appendix H 
contains programs that illustrate a few of the Atari system’s capabilities. 
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TERMINOLOGY 


GENERAL 

INFORMATION 


This section explains BASIC terminology, special notations, and abbreviations 
used in this manual, and the special keys on the ATARI 400*^“ and ATARI 800 ™ 
Personal Computer Systems keyboard. It also points to other sections where 
BASIC commands deal with specific applications. 


BASIC: Beginner’s All-purpose Symbolic Instruction Code. 


BASIC Keyword: Any reserved word “legal” in the BASIC language. May be 
used in a statement, as a command, or for any other purpose. (See Appendix A 
for a list of all “reserved words” or keywords in ATARI BASIC.) 


BASIC Statement: Usually begins with a keyword, like LET, PRINT, or 
RUN. 


Constant: A constant is a value expressed as a number rather than represented 
by a variable name. For example, in the statement X = 100, X is a variable and 
100 is a constant. (See Variable.) 


Command String: Multiple commands (or program statements) placed on the 
same numbered line separated by colons. 


Expression: An expression is any legal combination of variables, constants, 
operators, and functions used together to compute a value. Expressions can be 
either arithmetic, logical, or string. 


Function: A function is a computation built into the computer so that it can be 
called for by the user’s program. A function is NOT a statement; it is part of an 
expression. It is really a subroutine used to compute a value which is then 
“returned” to the main program when the subroutine returns. COS (Cosine), 
RND (random), FRE (unused memory space), and INT (integer) are examples of 
functions. In many cases the value is simply assigned to a variable (stored in a 
variable) for later use. In other cases it may be printed out on the screen im¬ 
mediately. See Section 6 for more on functions. Examples of functions as they 
might appear in programs are; 


10 pRif-rr RiKGi) 

10 X=100+COS(45) 


(print out the random 
number returned) 

(add the value re¬ 
returned to 100 and 
store the total in 
variable X) 
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Logical Line: A logical line consists of one to three physical lines, and is ter¬ 
minated either by a |jJ32]2J| or automatically when the maximum logical line 
limit is reached. Each numbered line in a BASIC program consists of one logical 
line when displayed on the screen. When entering a line which is longer than 
one physical line, the cursor will automatically go to the beginning of the next 
physical line when the end of the current physical line is reached. If ESDEIJlis 
not entered, then both physical lines will be part of the same logical line. 


Operator: Operators are used in expressions. Operators include addition (+), 
subtraction (-), multiplication ( * ), division (/), exponentiation (^), greater than 
(>), less than (<), equal to(=), greater than or equal to(>=), less than or equal to 
(<=), and not equal to (<>). The logical keywords AND, NOT and OR are also 
operators. The + and - operators can also be used as unary operators; e.g., -3. 
Do not put several unary operators in a row; e.g.,-3, as the computer will in¬ 

terpret it incorrectly. 

Physical Line: One line of characters as displayed on a television screen. 


String: A string is a group of characters enclosed in quotation marks. 
“ABRACADABRA” is a string. So are “ATARI MAKES GREAT COMPUTERS” 
and “123456789”. A string is much like a constant, as it too, may be stored in a 
variable. A string variable is different, in that its name must end in the 
character $. For example, the string “ATARI 800” may be assigned to a variable 


called A$ using (optional) LET like this: 


10 LET h$="ATAF:I 300" 

(note quotation marks) 

OR 


10 A$="AThR! 800" 

(LET is optional; the 


quotes are required.) 


Quotation marks may not be used within a string. However, the closing quota¬ 
tion can be omitted if it is the last character on a logical line. (See Section 7 - 

STRINGS). 

Variable: A variable is the name for a numerical or other quantity which may 
(or may not) change. Variable names may be up to 120 characters long. 
However, a variable name must start with an alphabetic letter, and may contain 
only capital letters and numerical digits. It is advisable not to use a keyword as a 
variable name or as the first part of a variable name as it may not be interpreted 
correctly. Examples of storing a value in a variable: 

LETC123DUB=1.234 
LETUhRIABLEI12=267.543 
LETA=1 
LETF5TH=6.5 
LETTHISNO = 53.803 

Note: LET is optional and may be omitted) 


Variable Name Limit: ATARI BASIC limits the user to 128 variable names.To 
bypass this problem, use individual elements of an array instead of having 
separate variable names. BASIC keeps all references to a variable which has 
been deleted from a program, and the name still remains in the variable name 
table. 



If the screen displays an ERROR-4 (Too Many Variables) message, use the follow¬ 
ing procedure to make room for new variable names: 

LIST filespec 

ENTER filespec 

The LIST filespec writes the untokenized version of the program onto a disk or 
cassette. NEW clears the program and the table areas. The program is then re¬ 
entered, re-tokenized, and a new variable table is built. (The tokenized version 
is Atari BASIC’s internal format. The untokenized versions in ATASCII 
which is the version displayed on the screen). 

Arrays and Array Variables: An array is a list of places where data can be 
filed for future use. Each of these places is called an element, and the whole array 
or any element is an array variable. For example, define “Array A” as having 6 
elements. These elements are referred to by the use of subscripted variables 
such as A(2), A(3), A(4), etc. A number can be stored in each element. This 
may be accomplished element by element (using the LET statement), or as a part 
of a FOR/NEXT loop (see Chapter 8). 

Note: Never leave blanks between the element number in parentheses and the 
name of the array. 


Correct 


Incorrect 


A(23) 

ARRAY(3) 

X123{38) 


A (23) 

ARRAY (3) 

X123 (38) 


SPECIAL 
NOTATIONS 
USED IN THIS 
MANUAL 


Line Format: The format of a line in a BASIC program includes a line number 
(abbreviated to lineno) at the beginning of the line, followed by a statement 
keyword, followed by the body of the statement and ending with a line ter¬ 
minator command ( J;Ui'i:i« kev). In an actual program, the four elements might 
look like this: 


STATEMENT 

Line Number Keyword Body Te rminat or 

100 PRINT A/X * (Z +4.567) COinnS 

Several statements can be typed on the same line provided they are separated by 
colons (:). See IF/THEN in Section 5, and Section 11. 

Capital Letters: In this book, denote keywords to be typed by the user in up¬ 
per case form exactly as they are printed in this text. Reverse-video characters 
will not work except in the case of the RUN command. Here are a few ex¬ 
amples: 

PRINT INPUT LIST END GOTO GOSUB FOR NEXT IF 

Lower Case Letters: In this manual, lower case letters are used to denote the 
various classes of items which may be used in a program, such as variables 
(var), expressions (exp), and the like. The abbreviations used for these classes of 
items are shown in Table 1.1. 
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Items in Brackets: Brackets, [ ], contain optional items which may be used, 
but are not required. If the item enclosed in brackets is followed by three dots 
[exp,...], it means that any number of expressions may be entered, but none are 
required. 

Items stacked vertically in braces: Items stacked vertically in braces indicate 
that any one of the stacked items may be used, but that only one at a time is per¬ 
missible. In the example below, type either the GOTO or the GOSUB. 


100 


GOTO 

GOSUB 


■2000 


Command abbreviations in headings: If a command or statement has an ab¬ 
breviation associated with it, the abbreviation is placed following the full name 
of the command in the heading; e.g., LET (L.). 


ABBREVIATIONS The following table explains the abbreviations used throughout this manual: 


USED IN THIS 
MANUAL 


TABLE 1.1 ABBREVIATIONS 


avar Arithmetic Variable: A location where a numeric value is 

stored. Variable names may be from 1 to 120 alphanumeric 
characters, but must start with an alphabetic character, and all 
alpha characters must be unreversed and upper case. 


svar String Variable: A location where a string of characters may be 

stored. The same name rules as avar apply, except that the last 
character in the variable name must be a $. String variables may 
be subscripted. See Section 7, STRINGS. 

mvar Matrix Variable: Also called a Subscripted Variable. An ele¬ 

ment of an array or matrix. The variable name for the array or 
matrix as a whole may be any legal variable name such as A, X, 
Y, ZIP, or K. The subscripted variable (name for the particular 
element) starts with the matrix variable, and then uses a number, 
variable, or expression in parentheses immediately following the 
array or matrix variable. For example, A(ROW), A(l), A(X +1). 


var Variable: Any variable. May be mvar, avar, or svar. 


aop Arithmetic operator, 

lop Logical operator. 

aexp Arithmetic Expression: Generally composed of a variable, 

function, constant, or two arithmetic expressions separated by an 
arithmetic operator. 

lexp Logical Expression: Generally composed of two arithmetic or 

string expressions separated by a logical operator. Such an ex¬ 
pression evaluates to either a 1 (logical true) or a 0 (logical false). 

For example, the expression 1<2 evaluates to the value 1 (true) 
while the expression “LEMON” = “ORANGE” evaluates to a zero 
(false) as the two strings are not equal. 
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sexp String Expression: Can consist of a string variable, string literal 

(constant), or a function that returns a string value. 

exp Any expression, whether sexp or aexp. 

lineno Line Number: A constant that identifies a particular program 

line in a deferred mode BASIC program. Must be any integer 
from 0 through 32767. Line numbering determines the order of 
program execution. 

adata ATASCII Data: Any ATASCII character excluding commas and 

carriage returns. (See Appendix C.) 

filespec File Specification: A string expression that refers to a device 
such as the keyboard or to a disk file. It contains information on 
the type of I/O device, its number, a colon, an optional file name, 
and an optional filename extender. (See OPEN, Section 5.) 

Example filespec: “DliNATALIE.ED” 


OPERATING 

MODES 


Direct Mode: Uses no line numbers and executes instruction immediately after 
l;hill:l?l key is pressed. 


Deferred Mode: Uses line numbers and delays execution of instruction(s) until 
the RUN command is entered. 


Execute Mode: Sometimes called Run mode. After RUN command is entered, 
each program line is processed and executed. 

Memo Pad Mode: A non-programmable mode that allows the user to experi¬ 
ment with the keyboard or to leave messages on the screen. Nothing written 
while in Memo Pad mode affects the RAM-resident program. 


SPECIAL 

FUNCTION 

KEYS 



Reverse (Inverse) Video key, or “ATARI LOGO KEY”. Press¬ 
ing this key causes the text to be reversed on the screen (dark 
text on light background). Press key a second time to return to 
normal text. 


CAPS/LOWR 


Lower Case key: Pressing this key shifts the screen characters 
from upper case (capitals) to lower case. To restore the characters 
to upper case, press the key and the key 

simultaneously. 


Escape key: Pressing this key causes a command to be entered 
into a program for later execution. 

Example: To clear the screen, you would enter: 

10 PRINT “ EH I 


and press 


RETURN 


Escape is also used in conjunction with other keys to print special 
graphic control characters. See Appendix F and back cover for 
the specific keys and their screen-character representations. 
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Break key: Pressing this key during program execution causes 
execution to stop. Execution may be resumed by typing CONT 
followed by pressing . 

02221223 System Reset key: Similar to in that pressing this key 

stops program execution. Also returns the screen display to 
Graphics mode 0, clears the screen, and returns margins and 
other variables to their default values. 

Tab key: Press KUffaM and thcEi&liSSIkeys simultaneously to 
set a tab. To clear a tab, press the and ESZSESQX keys 

simultaneously. Used alone, theESEESnU^^''^^^®® ^he cursor to 
the next tab position. In Deferred mode, set and clear tabs by 
preceding the above with a line number, the command PRINT, a 
quotation mark, and press the key. 

Examples: 

too PRINT “ IS3 ESSI ” 

200 PRINT “ Ta tsm ” 

Default tab settings are placed at columns 7, 15, 23, 31, and 39. 

Insert key: Press the and keys simultaneously to 

insert a line. To insert a single character, press the and 

keys simultaneously. 

Delete key: Press the ElESB ^^d keys simultaneously 

to delete a line. To delete a single character, press and 

simultaneously. 

EHaZinHB Back Space key: Pressing this key replaces the character to the 
left of the cursor with a space and moves cursor back one space. 

J Clear key: Pressing this key while holding down the or 

G22] key blanks the screen and puts the cursor in the upper left 
corner. 

inaUnCI Return key: Terminator to indicate and end of a line of BASIC. 

Pressing this key causes a numbered line to be interpreted and 
added to a BASIC program RAM. An unnumbered line (in Direct 
mode) is interpreted and executed immediately. Any variables 
are placed in a variable table. 


The Atari Personal Computer System uses five arithmetic operators: 

+ addition (also unary plus; e.g., +5) 

- subtraction (also unary minus; e.g., - 5) 

• multiplication 
/ division 
A exponentiation 


LOGICAL The logical operators consists of two types: unary and binary. The unary 

OPERATORS operator is NOT. The binary operators are: 


ARITHMETIC 

OPERATORS 
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AND Logical AND 

OR Logical OR 


Examples: 

10 IF A=12 Am T=0 Ti£H PRINT 

10 A=<C>1) AND <N=^1> 

10 A = (C+1) OR tN-1) 

10 A = N0T<C+1> 


"G£XjD" ^th expressions must 
be true before GOOD is 
printed. 

If both expressions 
true, A= +1; otherwise 
A=0. 

If either expression 
true, A = +1; otherwise 
A=0. 

If expression is false, 

A = +1; otherwise A=0. 


The rest of the binary operators are relational. 

< The first expression is less than the second expression. 

>■ The first expression is greater than the second. 

= The expressions are equal to each other. 

< = The first expression is less than or equal to the second. 

> = The first expression is greater than or equal to the second. 

< > The two expressions are not equal to each other. 

These operators are most frequently used in IF/THEN statements and logical 
arithmetic. 


OPERATOR 

PRECEDENCE 


Operations within the innermost set of parentheses are performed first and pro¬ 
ceed out to the next level. When sets of parentheses are enclosed in another set, 
they are said to be “nested”. Operations on the same nesting level are performed 
in the following order: 


Highest <,>, = ,<=,>=,<-> 
precedence 


* 


,/ 


+ , - 


<)>. = ><=.>=>< > 

NOT 

AND 

Lowest OR 

precedence 


Relational operators used in string expres¬ 
sions. Have same precedence and are per¬ 
formed from left to right. 

Unary minus 
Exponentiation. 

Multiplication and division have the same 
precedence level and are performed from left 
to right. 

Addition and subtraction have the same 
precedence level and are performed from left 
to right. 

Relational operations in numeric expressions 
have the same precedence level from left to 
right. 

Unary operator 
Logical AND 
Logical OR 
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BUILT-IN 

FUNCTIONS 


GRAPHICS 


SOUND AND 
GAMES 

CONTROLLERS 


WRAPAROUND 
AND KEYBOARD 
ROLLOVER 


ERROR 

MESSAGES 


The section titled FUNCTION LIBRARY explains the arithmetic and special 
functions incorporated into Atari BASIC. 


Atari graphics include 9 graphics modes. The commands have been designed 
to allow maximum flexibility in color choice and pattern variety. Section 9 ex¬ 
plains each command and gives examples of the many ways to use each. 


The Atari Personal Computer is capable of emitting a large variety of sounds. 
including simulated explosions, electronic music, and “raspberries.” Section 10 
defines the commands for using the SOUND function and for controlling pad¬ 
dle, joystick, and keyboard controllers. 


The ATARI Personal Computer System has screen wraparound thus allowing 
greater flexibility. It also allows the user to type one key ahead. If the user 
presses and holds any key, it will begin repeating after V4 second. 


If a data entry error is made, the screen display shows the line reprinted preced¬ 
ed by the message ERROR- and the offending character is highlighted. After 
correcting the character in the original line, delete the line containing the 
ERROR- before pressing CSJHl • Appendix B contains a list of all the error 
messages and their definitions. 
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2 

COMMANDS 


whenever the cursor (O) is displayed on the screen, the computer is ready to ac¬ 
cept input. Type the command (in either Direct or Deferred mode), and press 
. This section describes the commands used to clear computer memory 
and other useful control commands.- 

The commands explained in this section arc the following: 


BYE 

NEW 

CONT 

REM 

END 

RUN 

LET 

STOP 

LIST 



BYE (B.) Format: BYE 

Example: BYE 

The current function of the BYE command is to exit BASIC and put the com¬ 
puter in Memo Pad mode. This allows the user to experiment with the keyboard 
or to leave messages on the screen without disturbing any BASIC program in 
memory. To return to BASIC, press QSSHSai • 

CONT (CON.) Format: CONT 

Example: CONT 

Typing this comm and followed by a liUiUilil causes program execution to 
resume. If a IISQ, STOP, or END is encountered, the program will stop until 
CONT is entered. Execution resumes at the next sequential line number 

following the statement at which the program stopped. 

Note: If the statement at which the program is halted has other comm ands on 
the same numbered line which were not executed at the time of the ESS* 
STOP, or END, they will not be executed. On CONT, execution resumes at the 
next numbered line. A loop may be incorrectly executed if. the program is 
halted before the loop completes execution. 

This command has no effect in a Deferred mode program. 

END Format: END 

Example: 1000 END 

This command terminates program execution and is used in Deferred mode. In 
Atari BASIC, an END is not required at the end of a program. When the end of 
the program is reached. Atari BASIC automatically closes all files and turns off 
sounds (if any). END may also be used in Direct mode to close files and turn off 
sounds. 
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LET (LE.) 


LIST (L.) 


NEW 


REM (R. 


SPACE 


Format: [LET] var = exp 

Example: LET X = 3.142 * 16 

LET X = 2 

This statement is optional in defining variables. It can just as easily be left out of 
the statement. It may be used, however, to set a variable name equal to a value. 

Format: LIST [lineno [, lineno] ] 

LIST [filespec [,lineno [,lineno] ] ] 

Examples: 

LIST 
LIST 10 
LIST, 10,100 

LIST "P.",20,100 
LIST "P" 

LIST "D^DEMO.LST" 


This command causes the computer to display the source version of all lines cur¬ 
rently in memory if the command is entered without line number(s), or to 
display a specified line or lines. For example, LIST 10,100 displays lines 

10 through 100 on the screen. If the user has not typed the lines into the com¬ 
puter in numerical order, a LIST will automatically place them in order. 


Typing L.“P will print the RAM-resident program on the printer. 


LIST can be used in Deferred mode as part of an error trapping routine (See 
TRAP in Section 4). 

The LIST command is also used in recording programs on cassette tape. The sec¬ 
ond format is used and a filespec is entered. (See Section 5 for more details on 
peripheral devices.) If the entire program is to be listed on tape, no line numbers 
need be specified. 


Example: LIST “Cl” 

1000 LIST “Cl” 


Format: NEW 

Example: NEW 

This command erases the program stored in RAM. Therefore, before typing 
NEW, either SAVE or CSAVE any programs to be recovered and used later. 
NEW clears BASIC’s internal symbol table so that no arrays (See Section 8) or 
strings (See Section 7) are defined. Used in Direct mode. 


or Format: REM text 

J Example: 10 REM ROUTINE TO CALCULATE X 

This command and the text following it are for the user’s information only. It is 
ignored by the computer. However, it is included in a LIST along with the other 
numbered lines. Any statement on the same numbered line which occurs after a 
REM statement will be ignored. 
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RUN (RU.) 


Format: RUN [filespec] 

Examples: RUN 

RUN “D:MENU” 

This command causes the computer to begin executing a program. If no filespec 
is specified, the current RAM-resident program begins execution. If a filespec is 
included, the computer retrieves the specified, tokenized program from the 
specified file and executes it. 

All variables are set to zero and all open files and peripherals are closed. All ar¬ 
rays, strings, and matrices are eliminated and all sounds are turned off. Unless 
the TRAP command is used, an error message is displayed if any error is 
detected during execution and the program halts. 

RUN can be used in Deferred mode. 

Examples: 10 PRINJ "aER AND OlER AGAIN." 

20 RUN 

Type RUN and press EaEnUI • To end, pressEHJ. 

To begin program execution at a point other than the first line number, type 
GOTO followed by the specific line number, then pressEaEUni. 

STOP (STO.) Format: STOP 

Example: 100 STOP 

When the STOP command is executed in a program, BASIC displays the 

message STOPPED AT LINE _ , terminates program execution, and 

returns to Direct mode. The STOP command does not close files or turn off 
sounds, so the program can be resumed by typing CONT Ua^iyj. 
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EDIT 

FEATURES 


In addition to the special function keys described in Section 1, there are cursor 
control keys that allow immediate editing capabilities. These keys are used in 
conjunction with the or keys. 


The following key functions are described in this section: 


^^3 


SHIFT 


Esa o 


Q 



SHIFT ■ INSEflT 


SHIFT 


SHIFT ■ CAPS/LOWR 


2 , 

EES 3 


BREAK 


1^3 


SCREEN 

EDITING 


The keyboard and display are logically combined for a mode of operation 
known as screen editing. Each time a change is completed on the screen, the 
key must be pressed. Otherwise, the change is not made to the program 
in RAM. 


Example: 


10 Kti'i 

20 PRINT 


PRESS RETURN 


! T t ir cn ■ 


TRIf 


30 PRINT "THIS IS LIIE 1 ON 


IHE SCREEN. 


To delete line 20 from the program, type the line number and press the EaJnUJI 
key. Merely deleting the line from the screen display does not delete it from the 
program. 


The screen and keyboard as I/O devices are described in Section 5. 




SHIFT 


Control key. Striking this key in conjunction with 
the arrow keys produces the cursor control functions 
that allow the user to move the cursor anywhere on 
the screen without changing any characters already 
on the screen. Other key combinations control the 
setting and clearing of tabs, halting and restarting 
program lists, and the graphics control symbols. 
Striking a key while holding the QQ key will pro¬ 
duce the upper-left symbol on those keys having 
three functions. 

Shift key: This key is used in conjunction with the 
numeric keys to display the symbols shown on the 
upper half of those keys. It is also used in conjunction 
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DOUBLE-KEY 

FUNCTIONS 


with other keys to insert and delete lines, return to a 
normal, upper case letter display, and to display the 
function symbols above the subtraction, equals, addi¬ 
tion, and multiplication operators as well as the 
brackets, [ ], and question mark,?. 

Cursor Control Keys 

GE9 □ Moves cursor up one physical line without changing 

the program or display. 

o Moves cursor one space to the right without disturb¬ 

ing the program or display. 

O Moves cursor down one physical line without chang¬ 

ing the program or display. 

ECU Q Moves cursor one space to the left without disturbing 

the program or display. 

Like the other keys on the Atari keyboard, holding the cursor control keys for 
more than 'A second causes the keys to repeat. 

Keys Used With 

EQ3 Inserts one character space. 

Deletes one character or space. 

B131 1 Stops temporarily and restarts screen display 

without “breaking out” of the program. 

2 Rings buzzer. 

3 Indicates end-of-file. 

Keys Used With 

MiiiJM Inserts one physical line. 

Deletes one physical line. 

■--laiJM E3EBSHH Returns screen display to upper-case alphabetic 

characters. 

Special Function Keys 

Stops program execution or program list, prints a 
READY on the screen, and displays cursor. 

1^3 Allows commands normally used in Direct mode to 

be placed in Deferred mode; e.g.. In Direct mode, 
BJJJ BHil clears the screen display. To clear the 
screen in Deferred mode, type the following after the 
program line number. Press then press PTW 

and EE3iB together. 

PRINT “ QQl 131^ ” 
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PROGRAM 

STATEMENTS 


This section explains the commands associated with loops, conditional and un¬ 
conditional branches, error traps, and subroutines and their retrieval. It also ex¬ 
plains the means of accessing data and the optional command used for defining 
variables. 

The following commands are described in this section: 

FOR, TO, STEP/NEXT IF/THEN POP 

GOSUB/RETURN ON, GOSUB RESTORE 

GOTO ON, GOTO TRAP 


FOR avar = aexpl TO aexp2 [STEP aexpS] 

NEXT avar 
FOR X = 1 TO 10 
NEXT X 

FOR Y = 10 TO 20 STEP 2 
NEXT Y 

FOR INDEX = Z TO 100 * Z 
NEXT INDEX 

This command sets up a loop and determines how many times the loop is exe¬ 
cuted. The loop variable (avar) is initialized to the value of aexpl. Each time the 
NEXT avar statement is encountered, the loop variable is incremented by the 
aexp3 in the STEP statement. The aexp3 can be positive or negative integers, 
decimals, or fractional numbers. If there is no STEP aexp3 command, the loop 
increments by one. When the loop completes the limit as defined by aexp2, it 
stops and the program proceeds to the statement immediately following the 
NEXT statement; it may be on the same line or on the next sequential line. 

Loops can be nested, one within another. In this case, the innermost loop is com¬ 
pleted before returning to the outer loop. The following example illustrates a 
nested loop program. 


FOR (F.), TO, 
STEP/NEXT (N.) 


Format: 


Examples: 


10 

FOR X=1 

TO 

3 

20 

PRINT " 

OUTER LOOP 

30 

2=0 



40 

2=2+2 



50 

FOR Y=1 

TO 

5 STEP 

60 

PRINT " 


imER 

70 

1€XT Y 



t© 

NEKT X 



90 

END 




Figure 4-1. Nested Loop Program 
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In Figure 4-1, the outer loop will complete three passes (X = 1 to 3 ). However, 
before this first loop reaches its NEXT X statement, the program gives control to 
the inner loop. Note that the NEXT statement for the inner loop must precede 
the NEXT statement for the outer loop. In the example, the inner loop’s number 
of passes is determined by the STEP statement (STEP Z). In this case, Z has 
been defined as 0, then redefined as Z + 2. Using this data, the computer must 
complete three passes through the inner loop before returning to the outer loop. 
The aexp3 in the step statement could also have been defined as the numerical 
value 2. 

The program run is illustrated in Figure 4-2. 


OUTER LOOP 
INNER LOOP 
INNER LOOP 
INNER LOOP 
OUTER LOOP 
INNER LOOP 
INNER LOOP 
INNER LOOP 
OUTER LOOP- 
INNER LOOP- 
INNER LOOP- 
INNER LOOP 


Figure 4-2. Nested Loop Exeeution 

The return address for the loops are placed in a special group of memory ad¬ 
dresses referred to as a stack. The information is “pushed” on the stack and 
when used, the information is “popped” off the stack (see POP.) 


GOSUB (GOS.) 
RETURN (RET.) 


Format: GOSUB lineno 

lineno 
RETURN 

Example: 100 GOSUB 2000 

2000 PRINT “SUBROUTINE” 
2010 RETURN 


A subroutine* is a program or routine used to compute a certain value, etc. It is 
generally used when an operation must be replaced several times within a pro¬ 
gram sequence using the same or different values. This command allows the 
user to “call” the subroutine', if necessary. The last line of the subroutine must 
contain a RETURN statement. The RETURN statement goes back to the physical 
line following the GOSUB statement. 

Like the preceding FOR/NEXT command, the GOSUB/RETURN command 
uses a stack for its return address. If the subrouti:ie is not allowed to complete 
normally; e.g., a GOTO lineno before a RETURN, the GOSUB address must be 
“popped” off the stack (see POP) or it could cause future errors. 


• Generally, a subroutine can do anything that can be done in a program. It is used to save memory 
and program-entering time, and to make programs easier to read and debug. 
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GOTO (G.) 


To prevent accidental triggering of a subroutine (which normally follows the 
main program), place an END statement preceding the subroutine. The follow¬ 
ing program demonstrates the use of subroutines. 


10 PRINT "J" 

20 REr1 EXANPLE USE OF GOSUB.-RETURN 
30 K=100 
40 GGSUB 1000 
50 X=120 


b0 ijUSUB 1000 

70 X=50 
80 GOSUB 1000 
90 END 
1000 Y=3:i:N 
1010 X=X+Y 

•4 rj“ i" ripfTijT »..« 

rKir-i i i 

1030 RETURN 


(clear screen) 


Figure 4-3. GOSUB/RETURN Program Listing 


In the above program, the subroutine, beginning at line 1000, is called three 
times to compute and print out different values of X and Y. Figure 4-4 illustrates 
the results of executing this program. 


4® 300 

480 360 

200 150 


Figure 4-4. GOSUB/RETURN Program Run 


Format: | GO TO 1 aexp 

(goto i 

Examples: 100 GOTO 50 

500 GOTO (X + Y) 


The GOTO command is an unconditional branch statement just like the GOSUB 
command. They both immediately transfer program control to a target line 
number or arbitrary expression. However, using anything other than a con¬ 
stant will make renumbering the program difficult. If the target line number is 
non-existent, an error results. Any GOTO statement that branches to a 
preceding line may result in an “endless” loop. Statements following a GOTO 
statement will not be executed. Note that a conditional branching statement (see 
IF/THEN)can be used to break out of a GOTO loop. The following program il¬ 
lustrates two uses of the GOTO command. 
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10 PRiirr 

20 pRinT =pRnrr "Ofc 

30 PRIHT "TICI" 

40 PRIffT "THREE" 

50 PRINT "FOUR" 


60 PRINT "FIiJE" 

65 GOTO 100 
70 PRINT 

90 PRINT "????????????????? 
95 END 


II 

II 

11 


100 PRINT "SIX" 
110 PRINT "SEUEN" 
120 PRINT "EIGHT" 
130 PRINT "NINE" 
140 PRINT "TEN" 
150 GOTO 70 


Figure 4-5. GOTO Program Listing 

Upon execution, the numbers in the above listing will be listed first followed by 
the three rows of symbols. The symbols listed on lines 70,80, and 90 are ignored 
temporarily while the program executes the GOTO 100 command. It proceeds 
with the printing of the numbers “SIX” through “TEN”, then executes the se¬ 
cond GOTO statement which transfers program control back to line 70. (This is 
just an example. This program could be rewritten so that no GOTO statements 
were used.) The program, when executed, looks like the following: 


0h£ 

TWO 

TlfEE 

FOUR 

FIIE 

SIX 

SEUEN 

EIGHT 

NI1€ 

TEN 





IF/THEN 


Figure 4-6. GOTO Program Run 

Format: IF aexp THEN | lineno | 

I statement [:statement...] | 
Examples: IF X = 100 THEN 150 

IF A$ = “ATARI” THEN 200 

IF AA = 145 and BB = 1 THEN PRINT AA, BB 

IF X = 100 THEN X = 0 
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The IF/THEN statement is a conditional branch statement. This type of branch 
occurs only if certain conditions are met. These conditions may be either 
arithmetical or logical. If the aexp following the IF statement is true (non-zero), 
the program executes the THEN part of the statement. If, however, the aexp is 
false (a logical 0), the rest of the statement is ignored and program control passes 
to the next numbered line. 


In the format, IF aexp THEN lineno, lineno must be a constant, not an expression 
and specifies the line number to go to if the expression is true. If several 
statements occur after the THEN, separated by colons, then they will be ex¬ 
ecuted if and only if the expression is true. Several IF statements may be nested 
on the same line. For example; 

100 IF X=5 THEN IF Y=3 THEN R=9^GOTO290 


The statements R = 9: GOTO 100 will be executed only if X = 5 and Y = 3. The 
statement Y = 3 will be executed if X = 5. 

The following program demonstrates the IF/THEN statement. 


5 GRAPHICS 0^? :? " IF DEMO" 

10 ? :? "ENTER A";aiFUT A 
20 IF A=1 THEN 40^ REM MllTIPLE STATEfENT 
S HERE WILL lEUER BE EFCUTED! ! 

30 ? =? "A IS NOT 1. DECUT I ON CONTINUE 
S HERE WHEN THE EXPRESSION IS FALSE." 

40 IF A=1 THEN ? =? "A=l"^? "YES. IT IS 
REALLY l.":REM MULTIPLE STATEMENTS HERE 
WILL BE EXECUTED ONLY IF A=1!! 


50 


nc-'cr* 


XECLITION CONTINUES HERE IF AO 


1 OR AFTER 'YES,. IT IS REALLY 1’ IS DISP 
LAVED." 

60 GOTO 10 


Figure 4-7. IF/THEN Program 


ENTER A (entered 2) 

A IS NOT 1. EXECUTION CONTINUES HERE WH 
EN THE EXPRESSION IS FALSE. 

EXECUTION CONTINUES HERE IF AOl OR AFTE 
R 'YES. IT IS REALLY 1' IS DISPLAYED. 

ENTER A (entered 1) 

A=1 

YES. IT IS REALLY 1. 

E:€CUTI0N CiONTINUES HERE IF AOl OR AFTE 
R 'YES. IT IS REALLY 1' IS DISPLAYED. 

ElfTER A 


Figure 4-8. IF/THEN Program Execution. 
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ON/GOSUB/ 

RETURN 

ON/GOTO 


Format: ON aexp I GOTol lineno [ ,lineno...] 

Igosub) 

Examples: 100 ON X GOTO 200, 300, 400 
100 ON A GOSUB 1000, 2000 
100 ON SQ.R(X) GOTO 30, 10, 100 

Note: GOSUB and GOTO may not be abbreviated. 

These two statements are also conditional branch statements like the IF/THEN 
statement. However, these two are more powerful. The aexp must evaluate to a 
positive number which is then rounded to the nearest positive integer (whole 
number) value up to 255. If the resulting number is 1, then program control 
passes to the first lineno in the list following the GOSUB or GOTO. If the 
resulting number is 2, program control passes to the second lineno in the list, 
and so on. If the resulting number is 0 or is greater than the number of linenos 
in the list, the conditions are not met and program control passes to the next 
statement which may or may not be located on the same line. With ON/GOSUB, 
the selected subroutine is executed and then control passes to the next state¬ 
ment. 

The following routine demonstrates the ON/GOTO statement: 


10 X=X+1 

20 ON X mo 100;200,.308.400,500 
30 IF X>5 THEN PRINT "COrPLETE." = ElCi 
40 GOTO 10 
50 END 

100 PRINT "hCW UORKINi: hT LINE 100"^GOTO 
10 

200 PRINT ''\m UORKTM: hT LINE 200"= GOTO 
10 

300 PRINT "ICiN WORKING AT LINE 380"= GOTO 
10 

400 PRINT "ICiW WORKING AT LINE 400"= GOTO 
10 

500 PRINT "NJjW WORKING AT LINE 508"= GOTO 
10 


Figure 4-9 ON/GOTO Program Listing 


When 

the program is executed, it looks like the following: 

NijW 

WORKING 

AT 

LINE 

100 

mi 

WORKING 

AT 

LINE 

200 

NOW 

WORKIrC 

AT 

LINE 

300 

m-i 

WORKING 

AT 

LINE 

4Ki 

NOW 

WORKING 

AT 

LINE 

508 

C0f1f 

-■LETE. 





POP 


Figure 4-10 ON/GOTO Program Execution 
POP 

1000 POP 
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Format: 

Example: 



RESTORE (RES.) 


In the description of the FOR/NEXT statement, the stack was defined as a group 
of memory addresses reserved for return addresses. The top entry in the stack 
controls the number of loops to be executed and the RETURN target line for a 
GOSUB. If a subroutine is not terminated by a RETURN statement, the top 
memory location of the stack is still loaded with some numbers. If another 
GOSUB is executed, that top location needs to be cleared. To prepare the stack 
for a new GOSUB, use a POP to clear the data from the top location in the stack. 

The POP command must be used according to the following rules: 

1. It must be in the execution path of the program. 

2. It must follow the execution of any GOSUB statement that is not brought 
back to the main program by a RETURN statement. 

The following example demonstrates the use of the POP command with a 
GOSUB when the RETURN is not executed: 

10 GGSL8 1000 

15 REM ll\€ 20 WILL NOT BE EXECUTED 
2*0 PRINT "NiORMAL RETURN PRINTS THIS I'ESS 
HU " 

30 PRINT "hBNORMhL RETURN PRINTS THIS ME 
•SSAGE." 

40 POP 
999 END 

10130 PRINT "Na-j EXECUTING SUBROUTINE." 

1010 GOTO 30 
1020 RETURN 

Figure 4-11. GOSUB Statement With POP 

Format: RESTORE [aexp] 

Example: 100 RESTORE 

The Atari Personal Computer System contains an internal “pointer” that 
keeps track of the DATA statement item to be read next. Used without the op¬ 
tional aexp, the RESTORE statement resets that pointer to the first DATA item 
in the program. Used with the optional aexp, the RESTORE statement sets the 
pointer to the first DATA item on the line specifed by the value of the aexp. This 
statement permits repetitive use of the same data. 

10 FOR N=1 TO 2 
20 REhD h 
30 RESTORE 
40 READ B 
50 ri=A+B 

60 PRINT "TOTAL EQUALS ";M 
70 NEXT N 
88 EfC 

90 DATA 30.15 

Figure 4-12. Restore Program Listing 

On the first pass through the loop, A will be 30 and B will be 30 so the total line 
50 will print SUM TOTAL EQUALS 60, but on the second pass, A will equal 15 
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and B, because of the RESTORE statement, will still equal 30. Therefore, the 
PRINT statement in line 50 will display SUM TOTAL EQUALS 45. 


TRAP (T.) 


Format: TRAP aexp 

Example: 100 TRAP 120 

The TRAP statement is used to direct the program to a specified line number if 
an error is detected. Without a TRAP statement, the program stops executing 
when an error is encountered and displays an error message on the screen. 

The TRAP statement works on any error that may occur after it has been ex¬ 
ecuted, but once an error has been detected and trapped, it is necessary to reset 
the trap with another TRAP command. This TRAP command may be placed at 
the beginning of the section of code that handles input from the keyboard so 
that the TRAP is reset after each error. PEEK(195) will give you an error 
message (see Appendix B). 25G*PEEK(187) + PEEK(186) will give you the number 
of the line where the error occurred. The TRAP may be cleared by executing a 
TRAP statement with an aexp whose value is from 32767 to 65535 (e.g., 40000). 
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5 


INPUT/OUTPUT 
COMMANDS AND DEVICES 


This section describes the input/output devices and how data is moved between 
them. The commands explained in this section are those that allow access to the 
input/output devices. The input commands are those associated with getting 
data into the RAM and the devices geared for accepting input. The output com¬ 
mands are those associated with retrieving data from RAM and the devices 
geared for generating output. 

The commands described in this section are: 


CLOAD 

INPUT 

OPEN/CLOSE 

READ/DATA 

CSAVE 

LOAD 

POINT 

SAVE 

DOS 

LPRINT 

PRINT 

STATUS 

ENTER 

INPUT/OUTPUT 

NOTE 

PUT/GET 

XIO 


DEVICES The hardware configuration of each of the following devices is illustrated in the 

individual manuals furnished with each. The Central Input/Output (CIO) sub¬ 
system provides the user with a single interface to access all of the system 
peripheral devices in a (largely) independent manner. This means there is a 
single entry point and a device-independent calling sequence. Each device has a 
symbolic device name used to identify it; e.g., K: for the keyboard. Each device 
must be opened before access and each must be assigned to an Input/Output Con¬ 
trol Block (lOCB). From then on, the device is referred to by its lOCB number. 

ATARI BASIC contains 8 blocks in RAM which identifies to the Operating 
System the information it needs to perform an I/O operation. This information 
includes the command, buffer length, buffer address, and two auxiliary control 
variables. ATARI BASIC sets up the lOCB’s, but the user must specify which 
lOCB to use. BASIC reserves lOCB ^0 for I/O to the Screen Editor, therefore the 
user may not request lOCB »0. The GRAPHICS statement (see Section 9) opens 
lOCB for input and output to the screen. (This is the graphics window St). 
lOCB )tl is used by BASIC for the LPRINT, CLOAD, and CSAVE commands. The 
lOCB number may also be referred to as the device (or file) number. lOCB’s 1 
through 5 are used in opening the other devices for input/output operations. If 
lOCB m is in use, it will prevent LPRINT or some of the other BASIC I/O 
statements from being performed. 

Keyboard: (K:) Input only device. The keyboard allows the user to read the 
converted (ATASCII) keyboard data as each key is pressed. 

Line Printer: (P:) Output only device. The line printer prints ATASCII 
characters, a line at a time. It recognizes no control characters. 

Program Recorder: (C:) Input and Output device. The recorder is a read/write 
device which can be used as either, but never as both simultaneously. The 
cassette has two tracks for sound and program recording purposes. The audio 
track cannot be recorded from the ATARI system, but may be played back 
through the television speaker. 
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CLOAD (CLOA.) 


CSAVE (CS.) 


Disk Drives: (Dl:, D2:, D3:, D4:) Input and Output devices. If 16K of RAM is 
installed, the ATARI can use from one to four disk drives. If only one disk drive 
is attached, there is no need to add a number after the symbolic device code D. 


Screen Editor: (E:) Input and Output device. This device uses the keyboard 
and display (see TV Monitor) to simulate a screen editing terminal. Writing to 
this device causes data to appear on the display starting at the current cursor 
position. Reading from this device activates the screen editing process and 
allows the user to enter and edit data. Whenever the key is pressed, the 

entire logical line within which the cursor resides is selected as the current 
record to be transferred by CIO to the user program. (See Section 9). 


TV Monitor: (S:) Input and Output device. This device allows the user to read 
characters from and write characters to the display, using the cursor as the 
screen addressing mechanism. Both text and graphics operations are supported. 
See Section 9 for a complete description of the graphics modes. 

Interface, RS-232: (R:) The RS-232 device enables the ATARI system to inter¬ 
face with RS-232-compatible devices such as printers, terminals, and plotters. It 
contains a parallel port to which the 80-column printer (ATARI 825™) can be at¬ 
tached. 


Format: CLOAD 

Examples: CLOAD 

100 CLOAD 


This command can be used in either Direct or Deferred mode to load a program 
from cassette tape into RAM for execution. On entering CLOAD, one bell rings 
to indicate that the PLAY button needs to be pressed followed by . 

However, do not press PLAY until after the tape has been positioned. Specific in¬ 
structions for CLOADing a program are contained in the ATARI 410 Program 
Recorder Manual. Steps for loading oversized programs are included in the 
paragraphs under CHAINING PROGRAMS at the end of this section. 


Format: CSAVE 

Examples: CSAVE 

100 CSAVE 
100 CS. 


This command is usually used in Direct mode to save a RAM-resident program 
onto cassette tape. CSAVE saves the tokenized version of the program. On enter¬ 
ing CSAVE two bells ring to indicate that the PLAY and RECORD buttons must 
be pressed followed by ITJ1II:I?I . Do not, however, press these buttons until the 
tape has been positioned. It is faster to save a program using this command 
rather than a SAVE “C” (see SAVE) because short inter-record gaps are used. 


Notes: Tapes saved using the two commands, SAVE and CSAVE, are not com¬ 
patible 


It may be necessary to enter an LPRINT (see LPRINT) before using 
CSAVE. Otherwise, CSAVE may not work properly. 

For specific instructions on how to connect and operate the hardware, 
cue the tape, etc., see the ATARI 410 Program Recorder Manual. 
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DOS (DO.) 


ENTER (E.) 


INPUT (I.) 


Format: DOS 

Example: DOS 


The DOS command is used to go from BASIC to the Disk Operating System 
(DOS). If the Disk Operating System has not been booted into memory, the com¬ 
puter will go into Memo Pad mode and the user must press QSSSuElSli to return 
to Direct mode. If the Disk Operating System has been booted, the DOS Menu is 
displayed. To clear the DOS Menu from the screen, press OSOXISli- Control 
then passes to BASIC. Control can also be returned to BASIC by selecting B (Run 
Cartridge) on the DOS Menu. 


The DOS command is usually used in Direct mode; however, it may be used in a 
program. For more details on this, see the Atari DOS Manual. 


Format: ENTER filespec 

Examples: ENTER “C 

ENTER “D:DEMOPR.INS” 


This statement causes a cassette tape to play back a program originally recorded 
using LIST (see Section 2, LIST). The program is entered in unprocessed (un- 
tokenized) form, and is interpreted as the data is received. When the loading is 
complete, it may be run in the normal way. The ENTER command may also be 
used with the disk drive. Note that both LOAD and CLOAD (see Section 2) clear 
the old program from memory before loading the new one. ENTER merges the 
old and new programs. This ENTER statement is usually used in Direct mode. 

Format: INPUT |^^aexp 

Examples: 100 INPLIT X 
100 INPUT N$ 

100 PRINT “ENTER THE VALUE OF X” 
no INPUT X 


1 I avar 

avar 1 

J J [ svar 

, svar ) 


This statement requests keyboard data from the user. In execution, the com¬ 
puter displays a ? prompt when the program encounters an INPUT statement. It 
is usually preceded by a PRINT statement that pi'ompts the user as to the type of 
information being requested. 

String variables are allowed only if they are not subscripted. Matrix variables 
are not allowed. 


The ^aexp is optional and is used to specify the file or device number from 
which the data is to be input (see Input/Output Devices). If no ^aexp is specified, 
then input is from the screen editor (E:). 


If several strings are to be input from the screen editor, type one string, press 
, type the next string, , etc. Arithmetic numbers can be typed on 

the same line separated by commas. 


10 

PRINT 

"ENTER 5 

NUMBERS 

TO BE SUMMED" 

20 

FOR N= 

1 TO 

5 



30 

INPUT 

y 




40 

C=C+X 





50 

NEXT N 





60 

PRINT 

"THE 

sun 

OF YOUR; 

NUMBERS IS ";C 

70 

END 






Figure 5-1 Input Program Listing 
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LOAD (LO.) 


LPRINT (LP.) 


NOTE (NO.) 


OPEN (O.) 
CLOSE (CL.) 


Format: LOAD filespec 

Example: LOAD “DIJANINE.BRY” 

This command is similar to CLOAD except the full file name system can be used. 
LOAD uses long inter-record gaps on the tape (see CLOAD) and uses the token- 
ized version of the program. When using only one disk drive, it is not necessary 
to specify a number after the “D” because the default is disk drive ^1. 


Format: LPRINT [exp]| | | exp...J 

Example: LPRINT “PROGRAM TO CALCULATE X” 

100 LPRINT X;“ ”;Y;“ ”;Z 


This statement causes the computer to print data on the line printer rather than 
on the screen. It can be used in either Direct or Deferred modes. It requires no 
device specifier and no OPEN or CLOSE statement. (BASIC uses lOCB tfl.) 


The above program listing illustrates a program that will add 5 numbers 
entered by the user. To print a program listing on the line printer, see LIST. 


Format: NOTE ffaexp, avar, avar 

Example: 100 NOTE #1, X, Y 

This command is used to store the current disk sector number in the first avar 
and the current byte number within the sector in the second avar. This is the 
current read or write position in the specified file where the next byte to be 
read or written is located. This NOTE command is used when writing data to a 
disk file (see POINT). The information in the NOTE command is written into a 
second file which is then used as an index into the first file. 


Formats: OPEN <^aexp,aexpl,aexp2, filespec 

CLOSE ^aexp 

Examples: 100 OPEN -?2,8,0,“D1:ATARI800.BAS” 

100 A$ = “D1:ATARI800.BAS” 

110 OPEN ^2,8,0,A$ 

150 CLOSE If2 

Before a device can be accessed, it must be opened. This “opening” process links 
a specific lOCB to the appropriate device handler, initializes any CIO-related con¬ 
trol variables, and passes any device-specific options to the device handler. The 
parameters for the OPEN command are defined as follows: 

>t Mandatory character that must be entered by the 

user. 

aexp Reference lOCB or file number to same parameters 

for future use (as in CLOSE command). Number 
may be 1 through 7. 
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aexpl 


Code number to determine input or output opera¬ 
tion. 


aexp2 


filespec 


Code 4 
8 
12 
6 


9 


input operation 
output operation 
input and output operation 
disk directory input operation 
(In this case, the filespec is the search specifica¬ 
tion.) 

end-of-file append (output) operation. Append is 
also used for a special screen editor input mode. 
This mode allows a program to input the next 
line from E: without waiting for the user to press 


Device-dependent auxiliary code. An 83 in this 
parameter indicates sideways printing on a printer 
(see appropriate manuals for control codes). 


Specific file designation. Must be enclosed in quota¬ 
tion marks. The format for the filespec parameter 
is shown in Figure 5-2. 


“D 1 : A T A R I 8 0 0 . B A S” 


Device- 

Code 

Device- 

Number 

(optional) 

Required - 
Colon 


File name- 

(up to 8 
characters- 
must begin 
witb alphabetic 
character) 


Period required - 
as separator if 
extender is used. 



Extender_ 

(optional)- 

Includes 

0-3 characters 


Note: Filenames are 
not used with 
the program 
recorder. 


Figure 5-2 Filename Breakdown 

The CLOSE command simply closes files that have been previou.sly opened with 
an OPEN command. Note in the example that the aexp following the mandatory 
tt character must be the same as the aexp reference number in the OPEN state¬ 
ment. 
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POINT (P.) 


PRINT (PR or ?) 


PUT(PU.)/ 

GET(GE.) 


READ (REA.) 
DATA (D.) 


Format: POINT ^aexp, avar, avar 

Example: 100 POINT ttZ, A,B 

This command is used when reading a file into RAM. The first avar specifies the 
sector number and the second avar specifies the byte within that sector where 
the next byte will be read or written. Essentially, it moves a software-controlled 
pointer to the specified location in the file. This gives the user “random” access 
to the data stored on a disk file. The POINT and NOTE commands are discussed 
in more detail in the DO.S Manual. 

Format: PRINT [<'aexp] {’| [exp] t,exp...] 

Examples: PRINT X, Y, Z, A$ 

100 PRINT “THE VALUE OF X IS ”;X 

100 PRINT “COMMAS”, “CAUSE”, “COLUMN”, “SPACING” 

100 PRINT -?3, A$ 


A PRINT command can be used in either Direct or Deferred mode. In Direct 
mode, this command prints whatever information is contained between the 
quotation marks exactly as it appears. In the first example, PRINT X,Y,Z,A$, the 
screen will display the current values of X,Y,Z, and A$ as they appear in the 
RAM-resident program. In the last example, PRINT ff3,A$, the ff3 is the file 
specifier (may be any number between 1 and 7) that controls to which device 
the value of A$ will be printed. (See Input/Output Devices.) 


A comma causes tabbing to the next tab location. Several commas in a row cause 
several tab jumps. A semicolon causes the next aexp or sexp to be placed im¬ 
mediately after the preceding expression with no spacing. Therefore, in the 
second example a space is placed before the ending quotation mark so the value 
of X will not be placed immediately after the word “IS”. If no comma or 
semicolon is used at the end of a PRINT statement, then aEanEIJI >s output and 
the next PRINT will start on the following line. 


Format: PUT #aexp, aexp 

GET ^acxp. 

Examples: 100 PUT ASC(“A”) 
200 GET ^1,X 


The PUT and GET are opposites. The PUT command^outputs a single byte from 
0-255 to the file specified by ^aexp. is a mandatory character in both these 
commands). The GET command reads one byte from 0-255 (using ^aexp to 
designate the file, etc. on diskette or elsewhere) and then stores the byte in the 
variable avar. 


Formats: READ var [ , var...] 

DATA adata [ , adata...] 

Examples: 100 READ A,B,C,D,E 

110 DATA 12,13,14,15,16 
100 READ A$,B$,C$,D$,E$ 

110 DATA EMBEE, EVELYN, CARLA, CORINNE, BARBARA 


These two commands are always used together and the DATA statement is 
always used in Deferred mode'. The DATA statement can be located anywhere 

'A Direct mode READ will only read data if a DATA slalement was executed in the program. 
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SAVE (S.) 


STATUS (ST.) 


XIO (X.) 


in the program, but must contain as many pieces of data as there are defined in 
the READ statement. Otherwise, an “out of data” error is displayed on the 
screen. 

String variables used in READ statements must be dimensioned and cannot be 
subscripted. (See STRINGS Section). Neither may array variables may be used in 
a READ statement. 

The DATA statement holds a number of string data for access by the READ 
statement. It cannot include arithmetical operations, functions, etc. Further¬ 
more, the data type in the DATA statement must match the variable type de¬ 
fined in the corresponding READ statement. 

The following program totals a list of numbers in a DATA statement: 


10 

FOR H=1 

TO 

5 

20 

READ D 



30 

ri=ii+D 



40 

NEXT N 



50 

PRINT " 

:5Uri 

TOTAL EQUALS 

60 

END 



70 

DATA 30 

.15. 

106.17.87 


Figure 5-3 Read/Data Program Listing 
The program, when executed, will print the statement: 

SUM TOTAL EQUALS 255. 


Format: SAVE filespec 

E.\ample: SAVE “Dl:YVONNE.PAT” 

The SAVE command is similar to the CSAVE command except that the full file 
name system can be used. The device code number is optional when using only 
one disk drive. The default is to disk drive ^1. SAVE, like LOAD, uses long inter¬ 
record gaps on the cassette (see CSAVE) and the tokenized form of the program. 


Format: STATUS ^aexp,avar 

Example: 350 STATUS ^1,Z 

The STATUS command calls the STATUS routine for the specified device (aexp). 
The status of the STATUS command (see ERROR MESSAGES, Appendix B) is 
stored in the specified variable (avar). This may be useful for future devices such 
as the RS-232 interface. 


Format: XIO cmdno, ^^aexp, aexpl, aexp2, filespec 

Example: XIO 18,/'6,0,0,“S:” 

The XIO command is a general input/output statement used for special opera¬ 
tions. One example is its use to fill an area on the screen between plotted points 
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and lines with a color (see Section 9). The parameters for this command are de 
fined as follows: 

cmdno Number that stands for the particular command to 

be performed. 


cmdno 

OPERATION 

3 

OPEN 

5 

GET RECORD 

7 

GET CHARACTERS 

9 

PUT RECORD 

11 

PUT CHARACTERS 

12 

CLOSE 

13 

STATUS REQUEST 

17 

DRAW LINE 

18 

FILL 

32 

RENAME 

33 

DELETE 

35 

LOCK FILE 

36 

UNLOCK FILE 

37 

POINT 

38 

NOTE 

254 

FORMAT 


EXAMPLE 

Same as BASIC OPEN 

These 4 commands are similar to 

BASIC INPUT GET, PRINT, and PUT 

respectively. 

Same as BASIC CLOSE 
Same as BASIC STATUS 
Same as BASIC DRAWTO 
See Section 9 

XIO 32,.?1,0,0,“D:TEMP.CAROL” 

XIO 33,ffl,0,0,“D:TEMP.BAS” 

XIO 35,^1,0,0,“D:TEMP.BAS” 

XIO 36,/fl,0,0,“D:TEMP.BAS” 

Same as BASIC POINT 
Same as BASIC NOTE 
XIO 254,^1,0,0,“D2:” 


aexp Device number (same as in OPEN). Most of the time 

it is ignored, but must be preceded by ». 

aexpl Two auxiliary control bytes. Their usage 

aexp2 depends on the particular device and command. In 

most cases, they are unused and are set to 0. 


filespec String expression that specifies the device. Must be 
enclosed in quotation marks. Although some com¬ 
mands, like Fill (Section 9), do not look at the 
filespec, it must still be included in the statement. 


CHAINING 

PROGRAMS 


If a program requires more memory than is available, use the following steps to 
string programs of less than the maximum memory available into one program. 


1 . 

2 . 

3. 


4. 

5. 

6 . 

7. 

8 . 

9. 


Type in the first part of the program in the normal way. 

The last line of the first part of the, program should contain only the line 
number and the command RUN“C:” 

Cue the tape to the blank section. Write down the program counter number 
for later RUN purposes. Press PLAY and RECORD buttons on the deck so that 
both remain down. 

Type SAVE“C:” and press . 

When the beeping sound occurs, press miiUtl again. 

When the screen displays “READY”, do not move tape. Type NEW . 

Repeat the above instructions for the second part of the program. 

As the second part of the program is essentially a totally new program, it is 
possible to re-use the line numbers used in the first part of the program. 

If there is a third part of the program, make sure the last line of the second 
part is a RUN“C:” command. 
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To execute a “chained” program, use the following steps: 

1. Cue the tape to the beginning of part 1 of the program. 

2. Press PLAY button on the recorder. 

3. Type RUN“C:”Eai!Iiia . 

4. When the “beep” sounds, press again. 

The computer automatically loads the first part of the program, runs it, and 
sounds a “beep” to indicate when to hit the space bar or to trigger the 

tape motor for the second LOAD/RUN. The loading takes a few seconds. 

Note: A one-part program can be recorded and reloaded in the same way or 
CSAVE and CLOAD can be used. 


Note: Remember to boot DOS before typing in your program. 


MODIFYING A 
BASIC PROGRAM 
ON DISK 


The procedure for modifying an existing BASIC program stored on a diskette is 
demonstrated in the following steps: 

1. Turn off ATARI console and insert BASIC cartridge. 

2. Connect disk drive and turn it on - without inserting diskette. 

3. Wait for Busy Light to go out and for the drive to stop. Open disk drive door. 

4. Insert diskette (with DOS) and close door. 

5. Turn on console. DOS should boot in and the screen show READY. 

6. To load program from disk, type 

LOAD “D:filename.ext 

7. Modify program (or type in new program). 

8. To save program on disk, type 

SAVE “D:filename.ext 

9. Always wait for the Busy light to go out before removing diskette. 

10. To get a Directory listing, do not remove diskette and type 

_ DOS 

Upon , the DOS Menu will be displayed. Select command letter A, 

type it, and press twice to list the directory on the screen; or type A 

followed by pressing then P: to list directory on the printer. 

11. To return to BASIC, type B or press • 
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FUNCTION 

LIBRARY 


This section describes the arithmetic, trigonometric, and special purpose func¬ 
tions incorporated into the ATARI BASIC. A function performs a computation 
and returns the result (usually a number) for either a print-out or additional 
computational use. Included in the trigonometric functions are two statements, 
radians (RAD) and degrees (DEG), that are frequently used with trigonometric 
functions. Each function described in this section may be used in either Direct 
or Deferred mode. Multiple functions are perfectly legal. 

The following functions and statements are described in this section: 


ABS 

ATN 

ADR 

CLOG 

COS 

FRE 

EXP 

SIN 

PEEK 

INT 

DEG/RAD 

POKE 

LOG 


USR 

RNO 



SGN 



SQR 




ARITHMETIC 

FUNCTIONS 


ABS 


CLOG 


EXP 


INT 


Format: ABS(aexp) 

Example: 100 AB = ABS (-190) 

Returns the absolute value of a number without regard to whether it is positive 
or negative. The returned value is always positive. 


Format: CLOG (aexp) 

Example: 100 C = CLOG(83) 

Returns the logarithm to the base 10 of the variable or expression in paren¬ 
theses. CLOG(O) should give an error and CLOG(l) should be 0. 


Format: EXP (aexp) 

Example: 100 PRINT EXPO) 

Returns the value of e (approximately 2.71828283), raised to the power specified 
by the expression in parentheses. In the example given above, the number 
returned is 20.0855365. In some cases, EXP is accurate only to six significant 
digits. 


Format: INT (aexp) 

Examples: 100 I = INT(3.445) (3 would be stored in I) 

100 X = INT(-14.66778) (-15 would be stored in X) 
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Returns the greatest integer less than or equal to the value of the expression. 
This is true whether the expression evaluates to a positive or negative number. 
Thus, in our first example above, I is used to store the number 3. In the second 
example, X is used to store the number -15 (the first whole number that is less 
than or equal to -14.66778). This INT function should not be confused with the 
function used on calculators that simply truncates (cuts off) all decimal places. 

LOG Format: LOG(aexp) 

Example: 100 L = LOG(67.89/2.57) 

Returns the natural logarithm of the number or expression in parentheses. 
LOG(O) should give an error and LOG(l) should be 0. 

RND Format: RND(aexp) 

Example: 10 A = RND (0) 

Returns a hardware-generated random number between 0 and 1, but never 
returns 1. The variable or expression in parentheses following RND is a dummy 
and has no effect on the numbers returned. However, the dummy variable must 
be used. Generally, the RND function is used in combination with other BASIC 
statements or functions to return a number for games, decision making, and the 
like. Here’s a simple routine that returns a random number between 0 and 999. 


10 X=RHD( 0 ) (0 is dummy variable) 

20 RX=INT<1000*:>O 

30 pRif-rr Kx 


Format: SGN(aexp) 

Example: 100 X = SGN(-199) (-1 would be returned) 

Returns a -1 if aexp evaluates to a negative number; a 0 if aexp evaluates to 0, or a 
1 if aexp evaluates to a positive number. 

Format: SQ,R(aexp) 

Example: 100 PRINT SQR(IOO) (10 would be printed) 

Returns the square root of the aexp which must be positive. 


TRIGONOMETRIC 

FUNCTIONS 


ATN Format: ATN(aexp) 

Example: 100 X = ATN(65) 

Returns the arctangent of the variable or expression in parentheses. 

COS Format: COS(aexp) 

Example: 100 C = COS(X +Y + Z) 

Note: Presumes X, Y, Z previously defined! 

Returns the trigonometric cosine of the expression in parentheses. 
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SGN 

SQ^ 



SIN 


DEG/RAD 


SPECIAL 

PURPOSE 

FUNCTIONS 

ADR 


ERE 


PEEK 


POKE 


Format: SIN(aexp) ; 

Example: 100 X = SIN(Y) \ 

\ 

Note: Presumes Y previously defined. L — 

Returns the trigonometric sine of the expression in parentheses. 


Format: DEG 

RAD 

Example: 100 DEG 

100 RAD 

These two statements allow the programmer to specify degrees or radians for 
trigonometric function computations. The computer defaults to radians unless 
DEG is specified. Once the DEG statement has been executed, RAD must be used 
to return to radians. 

See Appendix E for the additional trigonometric functions that can be derived. 


Format: ADR(svar) 

Example: ADR(A$) 

Returns the decimal memory address of the string specified by the expression in 
parentheses. Knowing the address enables the programmer to pass the informa¬ 
tion to USR routines, etc. (See USR and Appendix D) 

Format: FRE(aexp) 

Examples: PRINT ERE (0) 

100 IF FRE (OX 1000 THEN PRINT “MEMORY CRITICAL” 

This function returns the number of bytes of user RAM left. Its primary use is in 
Direct mode with a dummy variable (0) to inform the programmer how much 
memory space remains for completion of a program. Of course FRE can also be 
used within a BASIC program in Deferred mode. 

Format: PEEK(aexp) 

Examples: 1000 IF PEEK (4000) = 255 THEN PRINT “255” 

100 PRINT “LEFT MARGIN IS”; PEEK (82) 

Returns the contents of a specified memory address location (aexp). The address 
specified must be an integer or an arithmetic expression that evaluates to an in¬ 
teger between 0 and 65535 and represents the memory address in decimal nota¬ 
tion (not hexadecimal). The number returned will also be a decimal integer with 
a range from 0 to 255. This function allows the user to examine either RAM or 
ROM locations. In the first example above, the PEEK is used to determine 
whether location 4000 (decimal) contains the number 255. In the second exam¬ 
ple, the PEEK function is used to examine the left margin. 

Format: POKE aexpl, aexp2 

Examples: POKE 82, 10 

100 POKE 82, 20 


Function Library 35 



USR 


Although this is not a function, it is included in this section because it is closely 
associated with the PEEK function. This POKE command inserts data into the 
memory location or modifies data already stored there. In the above format, 
aexpl is the decimal address of the location to be poked and aexp2 is the data to 
be poked. Note that this number is a decimal number between 0 and 255. POKE 
cannot be used to alter ROM locations. In gaining familiarity with this command 
it is advisable to look at the memory location with a PEEK and write down the 
contents of the location. Then, if the POKE doesn’t work as anticipated, the 
original contents can be poked into the location. 

The above Direct mode example changes the left screen margin from its default 
position of 2 to a new position of 10. In other words, the new margin will be 8 
spaces to the right. To restore the margin to its normal default position, press 


SYSTEM RESET 


Format: USR (aexpl [, aexp2][, aexpS...]) 

Example: 100 RESULT = USR (ADD1,A*2) 

This function returns the results of a machine-language subroutine. The first ex¬ 
pression, aexpl, must be an integer or arithmetic expression that evaluates to an 
integer that represents the decimal memory address of the machine language 
routine to be performed. The input arguments aexp2, aexp3, etc., are optional. 
These should be arithmetic expressions within a decimal range of 0 through 
65535. A non-integer value may be used; however, it will be rounded to the 
nearest integer. 

These values will be converted from BASIC’s Binary Coded Decimal (BCD) 
floating point number format to a two-byte binary number, then pushed onto 
the hardware stack, composed of a group of RAM memory locations under 
direct control of the 6502 microprocessor chip. Figure 6-1 illustrates the struc¬ 
ture of the hardware stack. 

N (Number of arguments on the stack-may be 0) 

X, (High byte of argument X) 

Xj (Low byte of argument X) 

Y, (High byte of argument Y) 

Y^ (Low byte of argument Y) 

Z, (High byte of argument Z) 

Zj (Low byte of argument Z) 


R, (Low byte of return address) 

R 2 (High byte of return address) 

Figure 6-1. Hardware Stack Definition 

Note: X is the argument following the address of the routine, Y is the 
second, Z is the third, etc. There are N pairs of bytes. 


See Section 11 for a description of the USR function in machine language pro¬ 
gramming. Appendix D defines the bytes in RAM available for machine 
language programming. 
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ASC 


CHR$ 


STRINGS 


This section describes strings and the functions associated with string handling. 
Each string must be dimensioned (see DIM statement, Section 8) and each string 
variable must end with a $. A string itself is a group of characters “strung” 
together. The individual characters may be letters, numbers, or symbols 
(including the Atari special keyboard symbols.) A substring is a part of a longer 
string and any substring is accessible in Atari BASIC if the string has been pro¬ 
perly dimensioned (see end of section). The characters in a string are indexed 
from 1 to the current string length, which is less than or equal to the dimen¬ 
sioned length of the string. 

The string functions described in this section are: 

ASC STR$ 

CHR$ VAL 

LEN 


Format: ASC(sexp) 

Examples: lOOA = ASC(A$) 

This function returns the ATASCII code number for the first character of the 
string expression (sexp). This function can be used in either Direct or Deferred 
mode. Figure 7-1 is a short program illustrating the ASC function. 

10 DIM A$(3> 

20 hJ="E'' 

30 A=ASC''hI) 

40 PRINT A 


Figure 7-1. ASC Function Program 


When executed, this program prints a 69 which is the ATASCII code for the let¬ 
ter “E”. Note that when the string itself is used, it must be enclosed in quotation 
marks. 


Format: CHR$ (aexp) 

Examples: 100 PRINT CHR$ (65) 

100 A$ = CHR$ (65) 

This character string function returns the character, in string format, 
represented by the ATASCII code number(s) in parentheses. Only one character 
is returned. In the above examples, the letter A is returned. Using the ASC and 
CHR$ functions, the following program prints the upper case and lower case let¬ 
ters of the alphabet. 
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LEN 


STR$ 


VAL 


10 FOR 1=8 TO 25 

20 PRINT CHR$(ASC< "h" )+ICHR$< hSC( "a">+ 

I) 

30 NEXT I 

Figure 7-2. ASC and CHR$ Program Example 
Note: There can be only one STR$ and only one CHR$ in a logical comparison. 

Format: LEN (sexp) 

Example: 100 PRINT LEN(A$) 

This function returns the length in bytes of the designated string. This informa¬ 
tion may then be printed or used later in a program. The length of a string 
variable is simply the index for the character which is currently at the end of 
the string. Strings have a length of 0 until characters have been stored in them. 
It is possible to store into the middle of the string by using subscripting. 
However, the beginning of the string will contain garbage unless something 
was stored (using STO) there previously. 

The following routine illustrates one use of the LEN function: 

10 DIM A$<i8) 

20 RJ="ATARI" 

30 PRINT LEN(A$> 

Figure 7-3. LEN Function Example 
The result of running the above program would be 5. 


Format: STR$ (aexp) 

Example: A$ = STR$(65) 

This string from number function returns the string form of the number in 
parentheses. The above example would return the actual number 65, but it 
would be recognized by the computer as a string. 

Note: There can only be one STR$ and only one CHR$ in a logical comparison. 
For example, A = STR$(1)> STR$(2) is not valid and will not work correctly. 


Format: VAL(sexp) 

Example: 100A = VAL(A$) 

This function returns a number of the same value as the number stored as a 
string. This is the opposite of a STR$ function. Using this function, the computer 
can perform arithmetic operations on strings as shown in the following exam¬ 
ple program: 

10 DIM Bi-;:5) 

20 Bl="10008" 

30 B=SQR<l>AL(B$>> 

40 PRINT "THE SQUARE ROOT OF IS " 

Figure 7-4. VAL Function Program 
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Upon execution, the screen displays THE SQUARE ROOT OF B$ IS 100. 


It is not possible to use the VAL function with a string that does not start with a 
number, or that cannot be interpreted by the computer as a number. It can, 
however, intrepret floating point numbers; e.g.,VAL(“lE9”)would return the 
number 1,000,000,000. 


STRING Strings can be manipulated in a variety of ways. They can be split, concatenated, 

rearranged, and sorted. The following paragraphs describe the different 
manipulations. 

String Concatenation 

Concatenation means putting two or more strings together to form one large 
string. Each string to be included in a larger string is called a substring. Each 
substring must be dimensioned (see DIM). In Atari BASIC, a substring can con¬ 
tain up to 99 characters (including spaces). After concatenation, the substrings 
can be stored in another string variable, printed, or used in later sections of the 
program. Figure 7-5 is a sample program demonstrating string concatenation. 
In this program, A$, B$, and C$ are concatenated and placed in A$. 


10 Din 100 ), 8$-: 100 ). cp: 100 > 

20 hJ="STRINGS & SUBSTRINGS ARE DISCUSSE 
D " 

30 BI='TN 'ATARI BASIC--A SELF-TEACHING 
GUIDE"' 

40 C $="—CHAPTER 9." 

50 AJ( LEN(A$>+1>=BJ 
60 AJ(LEN<A$>+1)=C$ 

70 PRINT A$ 


Figure 7-5. String Concatenation Example 


String Splitting 


The format of a subscript string variable is as follows: 

svarname(aexpl[ ,aexp2]) 

The svarname is used to indicate the unsubscripted string variable name (with 
$). aexpl indicates the starting location of the substring and aexp2 (if used) in¬ 
dicates the ending location of the substring. If no aexp2 is specified, then the end 
of the substring is the current end of the string. The starting location cannot be 
greater than the current length of the string. The two example programs in 
Figure 7-6 illustrate a split string with no end location indicated and a split 
string with an ending location indicated. 


10 Din SK5y 
20 Sf="ABCD#" 

30 PRINT SJ<2> 

40 END 

Result is BCD. 

(without ending location) 


10 Din S$(20) 

20 S$="ATARI 300 BASIC 
30 PRINT SIC 7.9) 

40 END 

Result is 800. 

(with ending location) 


Figure 7-6. Split String Examples 
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string Comparisons and Sorts 


In string comparisons, the logical operators are used exactly the way they are 
with numbers. The second program in Appendix H is a simple example of bub¬ 
ble sort. 

In using logical operators, remember that each letter, number, and symbol is 
assigned an ATASCII code number. A few general rules apply to these codes: 

1. ATASCII codes for numbers are sized in order of the numbers’ real 
values and are always lower than the codes for letters (see Appendix C). 

2. Upper case letters have lower numerical values than the lower case let¬ 
ters. To obtain the ATASCII code for a lower case letter if you know the 
upper case value, add 32 to the upper case code. 


Note: Atari BASIC’s memory management system moves strings around in 
memory to make room for new statements. This causes the string address to 
vary if a program is modified or Direct mode is used. 
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ARRAYS AND 
MATRICES 


An array is a one-dimensional list of numbers assigned to subscripted variables; 
e.g., A(0), A(l), A(2). Subscripts range from 0 to the dimensioned value. Figure 
8-1 illustrates a 7-element array. 


A(0) 

All) 

A(2) 

A(3) 

A(4) 

A(5) 

A(6) 


Figure 8-1. Example of an Array 

A matrix, in this context, is a two-dimensional table containing rows and col¬ 
umns. Rows run horizontally and columns run vertically. Matrix elements are 
stored by BASIC in row-major order. This means that all the elements of the 
first row are stored first, followed by all the elements of the second row, etc. 
Figure 8-2 illustrates a 7x4 matrix. 


0 


Columns 


M(0,0) 

M(0,1) 

M(0,2) 

M(0,3) 

M(1,0) 

M(l,l) 

M{1,2) 

M(l,3) 

M{2,0) 

M(2,l) 

M(2,2) 

M(2,3) 

M(3,0) 

M(3,l) 

M(3,2) 

M(3,3) 

M(4,0) 

M(4,l) 

M(4,2) 

M(4,3) 

M(5,0) 

M{5,1) 

M(5,2) 

M(5,3) 

M(6,0) 

M(6,l) 

M(6,2) 

M(6,3) 


Figure 8-2. Example of a Matrix 

This section describes the two commands associated with arrays, matrices, and 
strings, and how to load both arrays and matrices. The commands in this sec¬ 
tion are; 

DIM 
CLR 

DIM (DI.) Format: 

DIM I 

I mvar(aexp[,aexp]) 


Examples: DIM A(IOO) 

DIM M(6,3) 

DIM B$(20) used with STRINGS 


,svar{aexp) 

,mvar(aexp[,aexp... ] 
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A DIM statement is used to reserve a certain number of locations in memory for 
a string, array, or matrix. A character in a string takes one byte in memory and 
a number in an array takes six bytes. The first example reserves 101 locations 
for an array designated A. The second example reserves 7 rows by 4 columns 
for a two-dimensional array (matrix) designated M. The third example reserves 
20 bytes designated B$. All strings, arrays, and matrices must be dimen¬ 
sioned. It is a good habit to put all DIM statements at the beginning of the pro¬ 
gram. Notice in Figure 8-1 that although the array is dimensioned as DIM A(6), 
there are actually 7 elements in the array because of the 0 element. Although 
Figure 8-2 is dimensioned as DIM M(6,3), 28 locations are reserved. 


Note: The ATARI Personal Computer does not automatically initialize array or 
matrix variables to 0 at the start of program execution. To initialize array or 
matrix elements to 0, use the following program steps: 


250 Din A(180> 

300 FOR E=0 TO 100 
310 A(3)=0 
320 HD^T E 


Arrays and matrices are “filled” with data by using FOR/NEXT statements, 
READ/DATA statements and INPUT commands. Figure 8-3 illustrates the 
“building” of part of an array using the FOR/NEXT loop and Figure 8-4 builds an 
array using the READ/DATA statements. 


10 

DIM A*-. 103 ) 

2-0 

X=10 


30 

FOR E=i 

TO 90 

40 

X=X+1 


50 

A(E>=X 


60 

HEXT E 


70 

FOR E=1 

TO 90 

'^3 

PRINT E. 

A(E) 

90 

HEXT E 



Figure 8-3. Use of FOR/NEXT to Build An Array 


10 DIM A(3) 

20 FOR E=1 TO 3 
30 READ X 
40 A<E>=X 
50 PRIirr A(E;', 

60 HEXT E 
70 END 

lKi DATA 33.*45il2 


Figure 8-4. Use of READ/DATA to Build An Array 
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Figure 8-5 shows an example of building a 6 x 3 matrix. 


CLR 


10 DIM 

20 FOR Ra'l=0 TO 6 

30 FOR C0L=1 TO 3 

40 n(ROW.. COL >=IHT(RND‘;:0>*1080 > 

50 h€XT COL^hOT ROW 

60 FOR ROW=0 TO 6 

70 FOR C0L=1 TO 3 

30 PRINT ri(R0W.C0L> 

90 NEXT COL^PRINT ^NEXT ROW 


Figure 8-5. Building A Matrix 

Note that the words ROW and COLUMN are not BASIC commands, statements, 
functions, or keywords. They are simply variable names used here to designate 
which loop function is first. The program could just as easily have been written 
with X and Y as the variable names. 

Format: CLR 

Example: 200 CLR 

This command clears the memory of all previously dimensioned strings, arrays, 
and matrices so the memory and variable names can be used for other purposes. 
It also clears the values stored in undimensioned variables. If a matrix, string, or 
array is needed after a CLR command, it must be redimensioned with a DIM 
command. 
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GRAPHICS (GR.) 


GRAPHICS MODES 
AND COMMANDS 


This section describes the Atari BASIC commands and the different graphics 
modes of the ATARI Personal Computer. Using these commands, it is possible to 
create graphics for game, graphics, and patterns. 

The commands to be described in this section are: 

GRAPHICS LOCATE PUT/GET 

COLOR PLOT SETCOLOR 

DRAWTO POSITION XIO 

The PUT/GET and XIO commands explained in this section are special applica¬ 
tions of the same commands described in Section 5. 


Format: GRAPHICS aexp 

Example: GRAPHICS 2 


This command is used to select one of the nine graphics modes. Table 9-1 sum¬ 
marizes the nine modes and the characteristics of each. The GRAPHICS com¬ 
mand automatically opens the screen, S:(the graphics window), as device ^6. So 
when printing text in the text window, it is not necessary to specify the device 
code. The aexp must be positive, rounded to the nearest integer. Graphics mode 
0 is a full-screen display while modes 1 through 8 are split screen displays. To 
override the split-screen, add the characters +16 to the mode number (aexp) in 
the GRAPHICS command. Adding 32 prevents the graphics command from 
clearing the screen. 


To return to graphics mode 0 in Direct mode, press 
and press 


SYSTEM RESET 


or type GR.O 


TABLE 9.1—TABLE OF MODES AND SCREEN FORMATS 

SCREEN FORMAT 





Vert. 

Vert. 

Number 


Gr. 

Mode 

Horiz. 

(Col) 

(Col) 

Of 

RAM 

Mode 

Type 

(Rows) 

Split 

Full 

Colors 

Required 




Screen 

Screen 


(Bytes) 

0 

TEXT 

40 

- 

24 

2 

993 

1 

TEXT 

20 

20 

24 

5 

513 

2 

TEXT 

20 

10 

12 

5 

261 

3 

GRAPHICS 

40 

20 

24 

4 

273 

4 

GRAPHICS 

80 

40 

48 

2 

537 

5 

GRAPHICS 

80 

40 

48 

4 

1017 

6 

GRAPHICS 

160 

80 

96 

2 

2025 

7 

GRAPHICS 

160 

80 

96 

4 

3945 

8 

GRAPHICS 

320 

160 

192 

1/2 

7900 


The following paragraphs describe the nine graphics modes. 
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GRAPHICS 
MODE 0 


GRAPHICS 
MODES 
1 AND 2 


This mode is the 1-color, 2-luminance (brightness) default mode for the ATARI 
Personal Computer. It contains a 24 by 40 character screen matrix. The default 
margin settings at 2 and 39 allow 38 characters per line. Margins may be chang¬ 
ed by poking LMARGN and RMARGN (82 and 83). See Appendix I. Some systems 
have different margin default settings. The color of the characters is determined 
by the background color. Only the luminance of the characters can be different. 
This full-screen display has a blue display area bordered in black (unless the 
border is specified to be another color). To display characters at a specified loca¬ 
tion, use one of the following two methods. 


Method 1. 

lineno POSITION aexpl, aexp2 
lineno PRINT sexp 

Method 2 

lineno GR. 0 
lineno POKE 752,1 
lineno COLOR ASC(sexp) 

lineno PLOT aexpl,aexp2 

lineno GOTO lineno 


Puts cursor at location 
specified by aexpl and aexpZ. 

Specifies graphics mode. 
Suppresses cursor. 

Specifies character to be 
printed. 

Specifies where to print 
character. 

Start loop to prevent READY 
from being printed. (GOTO 
same lineno.) 


Press 

loop. 


BREAK 


to terminate 


GRAPHICS 0 is also used as a clear screen command either in Direct mode or 
Deferred mode. It terminates any previously selected graphics mode and 
returns the screen to the default mode (GRAPHICS 0). 


As defined in Table 9-1, these two 5-color modes are Text modes. However, they 
are both split-screen (see Figure 9-1) modes. Characters printed in Graphics 
mode 1 are twice the width of those printed in Graphics 0, but are the same 
height. Characters printed in Graphics mode 2 are twice the width and height 
of those in Graphics mode 0. In the split-screen mode, a PRINT command is used 
to display characters in either the text window or the graphics window. To 
print characters in the graphics window, specify device tt<o after the PRINT com¬ 
mand. 

Example: 100 GR. 1 

110 PRINT<f6;“ATARI” 

The default colors depend on the type of character input. Table 9-2 defines the 
default color and color register used for each type. 


Table 9-2. Default Colors for Specific Input Types 


Character Type 


Color Register Default Color 


Upper case alphabetical 0 

Lower case alphabetical 1 

Inverse upper case alphabetical 2 

Inverse lower case alphabetical 3 

Numbers 0 

Inverse numbers 2 


Note: See SETCOLOR to change character colors. 


Orange 
Light Green 
Dark Blue 
Red 

Orange 
Dark Blue 


46 Graphic Modes and Commands 



Unless otherwise specified, all characters are displayed in upper case non¬ 
inverse form. To print lower case letters and graphics characters, use a POKE 
756,226. To return to upper case, use POKE 756,224. 


In graphics modes 1 and 2, there is no inverse video, but it is possible to get all 
the rest of the characters in four different colors (see end of section). 


I 


(x.n) 

(V.O) 



5: 

Ciraplikii Window 
(|{ra|ihk'9 or text) 


E: 

Text Window 
(4 linra) 

border (alae 
dr|H*nds on 
individual 
I'V’a overst'an) 


Figure 9-1. Split-Screen Display For Graphics Modes 1 and 2 


The X and Y coordinates start at 0 (upper left of screen). The maximum values 
are the numbers of rows and columns minus 1 (see Table 9-1). 

This split-screen configuration can be changed to a full screen display by adding 
the characters +16 to the mode number. 

Example: GRAPHICS 1 + 16 


GRAPHICS 
MODES 
3, 5, AND 7 


These three 4-color graphics modes are also split-screen displays in their default 
state, but may be changed to full screen by adding +16 to the mode number. 
Modes 3, 5, and 7 are alike except that modes 5 and 7 use more points (pixels) in 
plotting, drawing, and positioning the cursor; the points are smaller, thereby 
giving a much higher resolution. 


GRAPHICS 
MODES 
4 AND 6 


GRAPHICS 
MODE 8 


These two 2-color graphics modes are split-screen displays and can display in 
only two colors while the other modes can display 4 and 5 colors. The advantage 
of a two-color mode is that it requires less RAM space (see Table 9-1). Therefore, 
it is used when only two colors are needed and RAM is getting crowded. These 
two modes also have a higher resolution which means smaller points than 
Graphics mode 3. 

This graphics mode gives the highest resolution of all the other modes. As it 
takes a lot of RAM to obtain this kind of resolution, it can only accomodate a 
maximum of one color and two different luminances. 
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COLOR (C.) 


DRAWTO (DR.) 


LOCATE (LOC.) 


Format: COLOR aexp 

Examples: 110 COLOR ASC(“A”) 

110 COLOR 3 

The value of the expression in the COLOR statement determines the data to be 
stored in the display memory for all subsequent PLOT and DRAWTO com¬ 
mands until the next COLOR statement is executed. The value must be positive 
and is usually an integer from 0 through 255. Non-integers are rounded to the 
nearest integer. The graphics display hardware interprets this data in different 
ways in the different graphics modes. In text modes 0 through 2, the number 
can be from 0 through 255 (8 bits) and determines the character to be displayed 
and its color. (The two most significant bits determine the color. This is why on¬ 
ly G4 different characters are available in these modes instead of the full 
256-character set.) 

Tables 9-6 and 9-7 at the end of this section illustrate the internal character set 
and the character/color assignment. Table 9-2 is a simplified table which allows 
easy generation of some of the colors. For example, COLOR ASC(“A”); PLOT 
5,5 will display an orange A character in graphics modes 1 or 2 at location 5,5. 

Graphics modes 3 through 8 are not text modes, so the data stored in the display 
RAM simply determines the color of each pixel. Two-color or two-luminance 
modes require either 0 or 1 (1-bit) and four-color modes require 0,1,2, or 3. (The 
expression in the COLOR statement may have a value greater than 3, but only 
one or two bits will be used.) The actual color which is displayed depends on the 
value in the color register which corresponds to the data of 0, 1, 2, or 3 in the 
particular graphics mode being used. This may be determined by looking in 
Table 9-5, which gives the default colors and the corresponding register 
numbers. Colors may be changed by using SETCOLOR. 

Note that when BASIC is first powered up, the color data is 0, and when a 
GRAPHICS command (without + 32) is executed, all of the pixels are set to 0. 
Therefore, nothing seems to happen to PLOT and DRAWTO in GRAPHICS 3 
through 7 when no COLOR statement has been executed. Correct by doing a 
COLOR 1 first. 


Format: DRAWTO aexpl, aexp2 

Example: 100 DRAWTO 10, 8 

This statement causes a line to be drawn from the last point displayed by a PLOT 
(see PLOT) to the location specified by aexpl and aexp2. The first expression 
represents the X coordinate and the second represents the Y-coordinate (see 
Figure 9-1). The color of the line is the same color as the point displayed by the 
PLOT. 

Format: LOCATE aexpl, aexp2, var 

Example: 150 LOCATE 12, 15, X 

This command positions the invisible graphics cursor at the specified location in 
the graphics window, retrieves the data at that pixel, and stores it in the 
specified arithmetic variable. This gives a number from 0 to 255 for Graphics 
modes 0 through 2; 0 or 1 for the 2-color graphics modes; and 0,1,2, or 3 for the 
4-color modes. The two arithmetic expressions specify the X and Y coordinates 
of the point. LOCATE is equivalent to: 

POSITION aexpl, aexp2:GET ^6,avar 
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PLOT (PL.) 


POSITION (POS.) 


PUT/GET 

(PU./GE.) 


Doing a PRINT after a LOCATE or GET from the screen may cause the data in 
the pixel which was examined to be modified. This problem is avoided by 
repositioning the cursor and putting the data that was read, back into the pixel 
before doing the PRINT. The following program illustrates the use of the 
LOCATE command. 


10 GRAPHICS 3+lb 
20 COLOR 1 
30 SETCOLOR 2.. 10.8 
40 PLOT 10.15 
50 DRAHTO 15.15 
60 LOCATE 12.i5.K 
70 PRINT K 


Figure 9-2. Ejrample Program Using LOCATE 

On execution, the program prints the data ( 1 ) determined by the COLOR state¬ 
ment which was stored in pixel 12, 15. 

Format: PLOT aexpl, aexp2 

Example: 100 PLOT 5,5 

The PLOT command is used in graphics modes 3 through 8 to display a point in 
the graphics window. The aexpl specifies the X-coordinate and the aexp2 the 
Y-coordinate. The color of the plotted point is determined by the hue and 
luminance in the color register from the last COLOR statement executed. To 
change this color register, and the color of the plotted point, use SET- 
COLOR. Points that can be plotted on the screen are dependent on the graphics 
mode being used. The range of points begins at 1 and extends to one less than 
the total number of rows (X-coordinate) or columns (Y-coordinate) shown in 
Table 9-1. 

Format: POSITION aexpl, aexp2 

Example: 100 POSITION 8, 12 

The POSITION statement is used to place the invisible graphics window cursor 
at a specified location on the screen (usually precedes a PRINT statement). This 
statement can be used in all modes. Note that the cursor does not actually move 
until an I/O command which involves the screen is issued. 

Formats: PUT #aexp, aexp 

GET #aexp, avar 

Examples: 100 PUT ^r6, ASC(“A”) 

200 GET xtl, X 

In graphics work, PUT is used to output data to the screen display. This state¬ 
ment works hand-in-hand with the POSITION statement. After a PUT (or GET), 
the cursor is moved to the next location on the screen. Doing a PUT to device Xf6 
causes the one-byte input (second aexp) to be displayed at the cursor position. 
The byte is either an ATASCII code byte for a particular character (modes 0-2) or 
the color data (modes 3-8). 

GET is used to input the code byte of the character displayed at the cursor posi¬ 
tion, into the specified arithmetic variable. The values used in PUT and GET cor¬ 
respond to the values in the COLOR statement. (PRINT and INPUT may also be 
used.) 
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Note: Doing a PRINT after a LOCATE or GET from the screen may cause the 
data in the pixel which was examined to be modified. To avoid this problem, 
reposition the cursor and put the data that was read, back into the pixel before 
doing the PRINT. 

SETCOLOR (S£.) Format: SETCOLOR aexpl, aexp2, aexp3 

Example: 100 SETCOLOR 0, 1, 4 

This statement is used to choose the particular hue and luminance to be stored 
in the specified color register. The parameters of the SETCOLOR statement are 
defined below: 

aexpl = Color register (0-4 depending on graphics mode) 
aexp2 = Color hue number (0-15. See Table 9-3) 

aexp3 = Color luminance (must be an even number between 0 and 14; the 
higher the number, the brighter the display. 14 is almost pure 
white.) 


TABLE 9.3—THE ATARI HUE (SETCOLOR COMMAND) 
NUMBERS AND COLORS 

COLORS 

SETCOLOR (aexp2) NUMBERS 

GRAY 

0 

LIGHT ORANGE (GOLD) 

1 

ORANGE 

2 

RED-ORANGE 

3 

PINK 

4 

PURPLE-BLUE 

6 

BLUE 

7 

BLUE 

8 

LIGHT BLUE 

9 

TURQUOISE 

10 

GREEN-BLUE 

11 

GREEN 

12 

YELLOW-GREEN 

13 

ORANGE-GREEN 

14 

LIGHT ORANGE 

15 

Note: Colors will vary with type and adjustment of TV or monitor used. 


The ATARI display hardware contains five color registers, numbered 
from 0 through 4. The Operating System (OS) has five RAM locations (COLORO 
through COLOR4, see Appendix I - Memory Locations) where it keeps track of 
the current colors. The SETCOLOR statement is used to change the values in 
these RAM locations. (The OS transfers these values to the hardware registers 
every television frame.) The SETCOLOR statement requires a value from 0 to 4 
to specify a color register. The COLOR statement uses different numbers 
because it specifies data which only indirectly corresponds to a color register. 
This can be confusing, so careful experimentation and study of the various 
tables in this section is advised. 

No SETCOLOR commands are needed if the default set of five colors is used. 
Although 128 different color-luminance combinations are possible, not more 
than five can be displayed at any one time. The purpose of the color registers 
and SETCOLOR statement is to specify these five colors. 
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TABLE 9.4—TABLE OF SETCOLOR “DEFAULT” COLORS* 


Setcolor 
(Color Register) 

Defaults To 
Color 

Luminance 

Actual Color 

0 

2 

8 

ORANGE 

1 

12 

10 

GREEN 

2 

9 

4 

DARK BLUE 

3 

4 

6 

PINK OR RED 

4 

0 

0 

BLACK 


’“DEFAULT” occurs if not SETCOLOR statement is used. 

Note: Colors may vary depending upon the television monitor type, condition, 
and adjustment. 


A program illustrating Graphics mode 3 and the commands explained so far in 
this section is shown below; 


10 GRAPHICS 3 

20 SETCOLOR 0.2.8=COLOR 1 

30 PLOT 17.M]R’hUT 0 17. lO^DRAWTO 9.18 

40 PLOT 19.1■ORAHTu 19.18 

50 PLOT Ltt.l-'DRAWTO 20.18 

60 PLOT 22.I^DRhHTQ 22.10=DRhWTO 38.18 

70 POKE 752.1 

30 PRINT ^PRINT " ATARI PERSONAL COMP 
UTERS” 

90 GOTO S'O 


The SETCOLOR and COLOR statements set the color of the points to be plotted 
(see Table 9.5). The SETCOLOR command loads color register 0 with hue 2 
(orange) and a luminance of 8 (“normal”). The next 4 lines plot the points to be 
displayed. Line 90 suppresses the cursor and line 100 prints the string expres¬ 
sion ATARI PERSONAL COMPUTERS in the text window (6 spaces in). 


Note that the background color was never set because the default is the desired 
color (black). 


If the program is executed, it will print the Atari logo in the graphics window 
and the string expression in the text window as in Figure 9-3. 
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Y-AXIS POINTS (ROWS) 


X-AXIS POINTS (COLUMNS) 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 1415 16 17 18 1920 2122 232425 26 2728293031 3233 34333G37 3839 



(GRAPHICS WINDOW) 

DEVICE CODE “S.” 
Screen 

(Graphics or Text) 


.(TEXT WINDOW) 

Editor 
DEVICE CODE “E.” 


(Text Only) 


Figure 9-3. Atari Logo Program Execution 
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TABLE 9.5—MODE, SETCOLOR, COLOR TABLE 


Default 

Colors 

Mode or 
Condition 

SETCOLOR 

(aexpl) 

Color 

Register No. 

Color 

(aexp) 

DESCRIPTION AND COMMENTS 



0 

COLOR data 


LIGHT BLUE 

MODE 0 and 

1 

actually 

Character luminance (same color as background) 

DARK BLUE 

ALL TEXT 

2 

determines 

Background 


WINDOWS 

3 

character to 

— 

BLACK 


4 

be plotted 

Border 

ORANGE 


0 

COLOR data 

Character 

LIGHT GREEN 

MODES 1 

1 

actually determines 

Character 

DARK BLUE 

and 

2 

character to be 

Character 

RED 

2 

3 

plotted 

Character 

BLACK 

(Text Modes) 

4 


Background,Border 

ORANGE 


0 

1 

Graphics point 

LIGHT GREEN 

MODES 3, 5, 

1 

2 

Graphics point 

DARK BLUE 

and 7 

2 

3 

Graphics point 


(Four-color 

3 

- 

— 

BLACK 

Modes) 

4 

0 

Graphics point (background default), Border 

ORANGE 

MODES 4 

0 

1 

Graphics point 


and 6 

1 

- 

— 


(Two-color 

2 

- 

— 


Modes) 

3 

- 

— 

BLACK 

4 

0 


Graphics point (background default), Border 

LIGHT GREEN 


0 



DARK BLUE 


1 

1 

Graphics point luminance (same color as background) 


MODE 8 

2 

0 

Graphics point (background default) 


(1 Color 

3 

- 

_ 

BLACK 

2 Luminances) 
_ 

4 

- 

Border 




























^4 


TABLE OF MODES 
AND SCREEN FORMATS 


X-7 


Gr. 

Mode 

Mode 

Type 

Iloriz. 

(Columns) 

Vert. (Rows) 
Split 
Screen 

V'^ert. (Rows) 
Full 
Screen 

aot 

Colors 

RAM 

Required 

(Bytes) 

0 

TEXT 

40 

- 

24 

2 

993 

1 

TEXT 

20 

20 

24 

5 

513 

2 

TEXT 

20 

10 

12 

5 

261 

3 

GRAPHICS 

40 

20 

24 

4 

273 

4 

GRAPHICS 

80 

40 

48 

2 

537 

5 

GRAPHICS 

80 

40 

48 

4 

1017 

6 

GRAPHICS 

160 

80 

96 

2 

2025 

7 

GRAPHICS 

160 

80 

96 

4 

3945 

8 

GRAPHICS 

320 

160 

192 

1/2 

7900 


MODE, SET COLOR, COLOR TABLE 


Default 

Colors 

Mode or 
Condition 

SETCOLOR 

(aexpl) 

Color 

Register No. 

Color 

(aexp) 

DESCRim iON ANIJ COMMENTS 



0 

COLOR dala 

_ 

LIGHT BLUE 

MODE 0 and 

1 

actuallv 

Character luminance (same color as backurmind) 

DARK BLUE 

ALL TEXT 

2 

determines 

Background 


WINDOWS 

3 

character to 

— 

BLACK 


4 

be plotted 

Border 

ORANGE 


0 

COLOR dala 

Character 

LIGHT GREEN 

MODES 1 

I 

actually determines 

Character 

DARK BLUE 

and 

2 

character to be 

Character 

RED 

2 

3 

plotted 

Character 

BLACK 

(Text Modes) 

4 


Backgrountl, Border 

ORANGE 


0 

1 

Graphics (xiint 

LIGHT GREEN 

MODES 3, 5, 

1 

2 

Graphics point 

DARK BLUE 

and 7 

2 

3 

Graphics point 


(Four-color 

3 

. 

— 

BLACK 

Modes) 

4 

0 

Graphics point (background deraulll. Border 

ORANGE 

MODES 4 

0 

1 

Graphics point 


and 6 

1 

- 

_ 


(Two-color 

2 

- 

— 


Modes) 

3 

- 

— 

BLACK 

4 

0 


Graphics point (background default). Border 

LIGHT GREEN 


0 

. 

_ 

DARK BLUE 


1 

1 

Graphics point luminance (same color as background) 


MODE 8 

2 

0 

Graphics jioini (background default) 


(1 Color 

3 

- 

— 

BLACK 

2 Luminances) 

4 

- 

Border 




















XIO (X.) 
SPECIAL FILL 
APPLICATION 


Format: XIO 18, #aexp, aexpl, aexp2, filespec 

Example: 100 XIO 18, ^G, 0, 0, “S:” 


This special application of the XIO statement fills an area on the screen between 
plotted points and lines with a non-zero color value. Dummy variables (0) are 
used for aexpl and aexp2. 

The following steps illustrate the fill process: 


1. PLOT bottom right corner (point 1). 

2. DRAWTO upper right corner (point 2). This outlines the right edge of the 
area to be filled. 

3. DRAWTO upper left corner (point 3). 

4. POSITION cursor at lower left corner (point 4). 

5. POKE address 765 with the fill color data (1, 2, or 3). 

6. This method is used to fill each horizontal line from top to bottom of the spe¬ 

cified area. The fill starts at the left and proceeds across the line to the right 
until it reaches a pixel which contains non-zero data (will wraparound if 
necessary). This means that fill cannot be used to change an area which has 
been filled in with a non-zero value, as the fill will stop. The fill command 
will go into an infinite loop if a fill with zero (0) data is attempted on a line 
which has no non-zero pixels. ESSoi' can be used to stop the 

fill if this happens. 


The following program creates a shape and fills it with a data (color) of 3. Note 
that the XIO command draws in the lines of the left and bottom of the figure. 


10 GRAPHICS 5+16 
20 COLOR 3 
30 PLOT 70.45 
40 DRAMTO 50.10 
50 DRAWTO 3u.I 0 
60 POSITION 10.45 
70 POKE 765.3 
80 XIO 18.#6.0.8."S " 
90 GOTO 30 


Figure 9-4. Example “FILL” Program 


Assigning Colors To Characters In Text Modes 1 and 2 

This procedure describes the method of assigning colors to the Atari character 
set. First, look up the character number in Table 9-G. Then, see Table 9-7 to get 
the conversion of that number required to assign a color register to it. 

Example: Assign SETCOLOR 0 to lower case “r” in mode 2 
whose color is determined by register 0. 

1. In Table 9-6, find the column and number for “r” (114-column 4). 

2. Using Table 9-7, locate column 4. Conversion is the character number minus 
32 (114 - 32 = 82). 
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Table 9.6—INTERNAL CHARACTER SET 


Column 1 

Column 2 

Column 3 

Column 4 


CHR 

it 

CHR 

it 

CHR 

it 

CHR 

it 

CHR 

it 

CHR 

it 

CHR 

it 

CHR 

0 

Space 

16 

0 

32 


48 

B 

64 


80 

Q 

96 

UM 

112 

P 

■■i 

17 

1 

33 

A 

49 

Q 

65 

ni 

81 

El 

97 

a 

113 

q 

2 

91 


2 

34 

B 

50 

R 

66 

rn 

82 

El 

98 

B 

114 


3 

it 


3 

35 

C 

51 

S 

67 

FI 

83 

FI 

99 

c 

115 

s 

4 

$ 

20 

4 

36 

D 

52 

T 

68 

FI 

84 

El 

100 


116 

t 

5 

% 

21 

5 

37 


53 

U 

69 

FI 

85 

El 

101 

e 

117 

u 

6 

6= 

22 

6 

38 

a 

54 

V 

70 

m 

86 

o 

102 

n 



7 

1 

23 

7 

39 

G 

55 

W 

71 

1^ 

87 

El 


g 

119 

w 

8 


24 

8 

40 

H 

56 

X 

72 

ga 

88 

El 

104 

B 


X 

9 


25 

9 

41 

I 

57 

Y 

73 

Q 

89 

DJ 

105 

i 


B 

10 

♦ 

26 

; 

42 

J 

58 

B 

74 

Rl 

90 

El 

106 

j 


z 

11 

+ 

27 

5 

43 

K 

59 


75 

FI 

91 

EO 

107 

B 

123 

□ 

12 

1 

28 

< 

44 


60 

\ 

76 

El 

92 

El 

108 


124 1 

13 

— 

29 

=z 

45 

M 

61 

] 

77 

Ifl 

93 

El 

109 

m 

125 


14 

— 

30 

> 

46 

N 

62 

A 

78 

D 

94 

El 

110 

n 


B 

15 

/ 

31 

p 

47 

O 

63 

— 

79 

El 

95 

El 

111 

o 

127 



1. In mode 0 these characters must be preceded with an escape, CHR$(27), to be printed. 





























































































































Table 9.7—CHARACTER/COLOR ASSIGNMENT 


Conversion 1 

Conversion 2 

Conversion 3 

Conversion 4 

MODE 0 

^SETCOLOR 2 

Xf + 32 

# + 32 

#-32 

NONE 


POKE 756,224 

POKE 756,226 

MODE 1 

SETCOLOR 0 

-*32 

# + 32 

#-32 

#-32 

OR 

SETCOLOR 1 

NONE 

# + 64 

#-64 

NONE 

MODE 2 

SETCOLOR 2 

if+160 

#+160 

# + 96 

# + 96 


SETCOLOR 3 

XT+128 

#+192 

# + 64 

#+128 


2. Luminance controlled by SETCOLOR 1, 0, LUM. 


3. POKE the Character Base Address (CHBAS) with 226 to specify lower case let¬ 
ters or special graphics characters; e.g., 

POKE 756,226 
or 

CHBAS = 756 
POKE CHBAS, 226 


To return to upper case letters, numbers, and punctuation marks, POKE CHBAS 
with 224. 

4. A PRINTstatement using the converted number (82) assigns the lower case 
“r” to SETCOLOR 0 in mode 2 (see Table 9-5). 

Graphic Control Characters 

These characters are produced when the BES key is pressed with the 
alphabetic keys shown on back cover. These characters can be used to draw 
design, pictures, etc., in mode 0 and in modes 1 and 2 if CHBAS is changed. 
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SOUND (SO.) 


SOUNDS AND GAME 
CONTROLLERS 


This section describes the statement used to generate musical notes and sounds 
through the audio system of the television monitor. Up to four different sounds 
can be “played” simultaneously creating harmony. This SOUND statement can 
also be used to simulate explosions, whistles, and other interesting sound ef¬ 
fects. The other commands described in this section deal with the functions 
used to manipulate the keyboard, joystick, and paddle controllers. These func¬ 
tions allow these controllers to be plugged in and used in BASIC programs for 
games, etc. 

The command and functions covered in this section are: 

SOUND PADDLE STICK 

PTRIG STRIG 


Format: SOUND aexpl, aexp2, aexpS, aexp4 

Example: 100 SOUND 2, 204, 10, 12 

The SOUND statement causes the specified note to begin playing as soon as the 
statement is executed. The note will continue playing until the program en¬ 
counters another SOUND statement with the same aexpl or an END statement. 
This command can be used in either Direct or Deferred modes. 


The SOUND parameters are described as follows: 

aexpl = Voice. Can be 0-3, but each voice requires a separate SOUND state¬ 
ment. 

aexp2 = Pitch. Can be any number between 0-255. The larger the number, 
the lower the pitch. Table 10-1 defines the pitch numbers for the 
various musical notes ranging from two octaves above middle C to 
one octave below middle C. 

aexp3 = Distortion. Can be even numbers between 0-14. Used in creating 
sound effects. A 10 is used to created a “pure” tone whereas a 12 
gives an interesting buzzer sound. A buzzing sound (like engines at 
a race track) can be produced using two separate SOUND commands 
with the distortion value (aexp3) alternating between 0 and 1. A 
value of 1 is used to force output to the speaker using the specified 
volume (see aexp4). The rest of the numbers are used for other 
special effects, noise generation, and experimental use. 

aexp4 = Volume control. Can be between 1 and 15. Using a 1 creates a sound 
barely audible whereas a 15 is loud. A value of 8 is considered nor¬ 
mal. If more than 1 sound statement is being used, the total volume 
should not exceed 32. This will create an unpleasant “clipped” tone. 
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Using the note values in Table 10-1, the following example demonstrates how to 
write a program that will “play” the C scale. 


TABLE 10.1. TABLE OF PITCH VALUES FOR THE MUSICAL 

NOTES 


HIGH 

NOTES 


MIDDLE C 


LOW NOTES 


c 

29 

B 

31 

A# or b1> 

33 

A 

35 

G# or a!» 

37 

G 

40 

Bif or gI* 

42 

F 

45 

E 

47 

D# or E 

50 

D 

53 

or dI> 

57 

C 

60 

B 

64 

Aif or B 

68 

A 

72 

G# or Ab 

76 

G 

81 

F# or Gb 

85 

F 

91 

E 

96 

or Eb 

102 

D 

108 

Cif or Db 

114 

C 

121 

B 

128 

Aff or Bb 

136 

A 

144 

G^ or Ab 

153 

G 

162 

F/f Gb 

173 

F 

182 

D 

193 

Dff or ib 

204 

D 

217 

Cff or Db 

230 

C 

243 


10 READ A 

20 IF A=256 THEN END 
30 SOUND 0,-A.. 10.10 
40 FOR N=1 TO 400:NEXT W 
50 PRINT A 
60 GOTO 10 
70 END 

80 E’ATA -31 .• 35.4u. 45.147.53.11-0.64. 
.91.96.108.121 

90 DATA 1 llo . 144.1 .1 'dd . 193. S17. i:!43 


't Ti 1 

1; Ol 


Figure 10-1, Musical Scale Program 

Note that the DATA statement in line 80 ends with a 256, which is outside of the 
designated range. The 256 is used as an end-of-data marker. 
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GAME 

CONTROLLER 

FUNCTIONS 


PADDLE 


PTRIG 


STICK 


Figure 10-2 is an illustration of the three controllers used with the Atari Per¬ 
sonal Computers. The controllers can be attached directly to the Atari Per¬ 
sonal Computer or to external mechanical devices so that outside events can be 
fed directly to the computer for processing and control purposes. 



Figure 10-2. Game Controllers 


Format: PADDLE(aexp) 

Example: PRINT PADDLEO) 

This function returns the status of a particular numbered controller. The paddle 
controllers are numbered 0-7 from left to right. This function can be used with 
other functions or commands to “cause” further actions like sound, graphics 
controls, etc. For example, the statement IF PAUDLE(3) = 14 THEN PRINT 
“PADDLE ACTIVE.” Note that the PADDLE function returns a number bet¬ 
ween 1 and 228, with the number increasing in size as the knob on the con¬ 
troller is rotated counterclockwise (turned to the left). 


Format: PTRIG(aexp) 

Example: 100 IF PTRIG(4) = 0 THEN PRINT “MISSILES FIRED!” 

The PTRIG function returns a status of 0 if the trigger button of the designated 
controller is pressed. Otherwise, it returns a value of 1. The aexp must be a 
number between 0 and 7 as it designates the controller. 


Format: STICK(aexp) 

Example: 100 PRINT STICK(3) 

This function works exactly the same way as the PADDLE command, but can be 
used with the joystick controller. The joystick controllers are numbered from 
0-3 from left to right. 

Controller 1 = STICK(O) 

Controller 2 = STlCK(l) 

Controller 3 = STICK(2) 

Controller 4 = STICK(3) 

Figure 10-3 shows the numbers that will be returned when the joystick con¬ 
troller is moved in any direction. 
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STRIG 


14 



Format: STRIG(aexp) 

Example: 100 IF STRIG(3) = 0 THEN PRINT “FIRE TORPEDO” 

The STRIG function works the same way as the PTRIG function. It can be used 
with both the joystick and keyboard controllers. 
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MEMORY 

CONSERVATION 


ADVANCED PROGRAMMING 

TECHNIQTJES 


This section includes hints on increasing programming efficiency, conserving 
memory, and combining machine language programs with Atari BASIC pro¬ 
grams. This section does not include an instruction set for the 6502 micro¬ 
processor chip nor does it give instructions on programming in machine 
language. An additional purchase of the Atari Assembler Editor cartridge* and 
a careful study of Atari’s Assembler Editor Manual are strongly recommended. 


These hints give ways of conserving memory. Some of these methods make pro¬ 
grams less readable and harder to modify, but there are cases where this is 
necessary due to memory limitations. 


1. In many small computers, eliminating blank spaces between words and 
characters as they are typed into the keyboard will save memory. This is not 
true of the ATARI Personal Computer System, which removes extra spaces. 
Statements are always displayed the same regardless of how many spaces 
were used on program entry. Spaces should be used (just as in typing on a 
conventional typewriter) between successive keywords and between 
keywords and variable names. Here is an example; 


10 IF A = 5 THEN PRINT A 


Note the space between IF and A and between THEN and PRINT. In most 
cases, a statement will be interpreted correctly by the computer even if all 
spaces are left out, but this is not always true. Use conventional spacing. 


2. Each new line number represents the beginning of what is called a new 
“logical line”. Each logical line takes 6 bytes of “overhead”, whether it is 
used to full capacity or not. Adding an additional BASIC statement by using a 
colon {:) to separate each pair of statements on the same line takes only 3 
bytes. 


‘Available late 1980. 
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If you need to save memory, avoid programs like this: 


10 X=Y+1 
20 Y=Y+1 
30 Z=X+Y 
40 PRINT Z 
50 GOTO 50 


and consolidate lines like this: 

10 X=X+1:Y=Y+1:Z=X+Y:F‘RINT Z--GOTO 10 


This consolidation saves 12 bytes. 


3. Variables and constants should be “managed” for savings, too. Each time a 
constant (4,5,16,3.14159, etc.) is used, it takes 7 bytes. Defining a new 
variable requires 8 bytes plus the length of the variable name (in characters). 
But each time it is used after being defined, it takes only 1 byte, regardless of 
its length. Thus, if a constant (such as 3.14159) is used more than once or 
twice in a program, it should be defined as a variable, and the variable name 
used throughout the program. For example: 


10 PI=3.14159 

20 PRINT "AREA OF A CIRCLE IS THE RADIUS 
SQUARED TINES ";PI 


4. Literal strings require 2 bytes overhead and 1 byte for each character 
(including all spaces) in the string. 


5. String variables take 9 bytes each plus the length of the variable name 
(including spaces) plus the space eaten up by the DIM statement plus the size 
of the string itself (1 byte per character, including spaces) when it is defined. 
Obviously, the use of string variables is very costly in terms of RAM. 


6. Definition of a new matrix requires 15 bytes plus the length of the matrix 
variable name plus the space needed for the DIM statement plus 6 times the 
size of the matrix (product of the number of rows and the number of col¬ 
umns). Thus, a 25 row by 4 column matrix would require 15 + approxi¬ 
mately 3 (for variable name) + approximately 10 (for the DIM statement) + 6 
times 100 (the matrix size), or about 630 bytes. 
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7. Each character after REM takes one byte of memory. Remarks are helpful to 
people trying to understand a program, but sometimes it is necessary to 
remove remark statements to save memory. 


8. Subroutines can save memory because one subroutine and several short calls 
take less memory than duplicating the code several times. On the other 
hand, a subroutine that is only called once takes extra bytes for the GOSUB 
and RETURN statements. 


9. Parentheses take one byte each. Extra parentheses are a good idea in some 
cases if they make an expression more understandable to the programmer. 
However, removing unnecessary parentheses and relying on operator 
precedence will same a few bytes. 


PROGRAMMING 
IN MACHINE 
LANGUAGE 


Machine language is written entirely in binary code. The ATARI Personal Com¬ 
puter contains a 6502 microprocessor and it is possible to call 6502 machine code 
subroutines from BASIC using the USR function. Short routines may then be 
entered into a program by hand assembly (if necessary). 


Before it returns to BASIC, the assembly language routine must do a pull ac¬ 
cumulator (PLA) instruction to remove the number (N) of input arguments off 
the stack. If this number is not 0, then all of the input arguments must be pop¬ 
ped off the stack also using PLA. (See Figure 6-1). 


The subroutine should end by placing the low byte of its result in location 212 
(decimal), and then return to BASIC using an RTS (Return from Subroutine) in¬ 
struction. The BASIC interpreter will convert the 2-byte binary number stored 
in locations 212 and 213 into an integer between 0 and 65535 in floating-point 
format to obtain the value returned by the USR function. 


The ADR function may be used to pass data that is stored in arrays or strings to a 
subroutine in machine language. Use the ADR function to get the address of the 
array or string, and then use this address as one of the USR input arguments. 


The following program, Hexcode Loader, provides the means of entering hexa¬ 
decimal codes, converting each hexadecimal number to decimal, and storing the 
decimal number into an array. The array is then executed as an assembly 
language subroutine. (An array is used to allocate space in memory for the 
routine.) 
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1. To use this program, first enter it. After entering it, save this program on 
disk or cassette for future use. 


10 GRAPHICS 0:PRINT "hCXCODE LOADER PROG 
RAN": PRINT 

20 REN STORES DECINAL EQUIUALENTS IN ARR¬ 
AY A. OUTPUTS IN PRINTED 'DATA STATEMENT 
S' AT 

21 REN LINE NUMBER 1508. 

30 REN USER Tf€N PLACES CURSOR ON PRINTE 
D OUTPUT LINE, HITS “RETURN", AND ENTERS 

31 REN REST OF BASIC PROGRAM INCLUDING U 
SR STATEMENT. 

40 DIN A<50>,HE:>::$(5) 

50 REN IhfUT,CONUER:SIiDN,STORAGE OF DATA. 

60 N=0:PRINT "ENTER 1 HE>:: CODE. IF LAST 
0f€ IS IN, ENTER 'DONE'."; 

70 INPUT he::::$ 

88 IF HEX$="D0NE" THEN hWj-GOTO 138 
90 FOR 1=1 TO lenche:x$:' 

100 IF HE:i$(I,IX="9" THEN N=N;sl6+UAL<HE 
X$<I,I)>:GOTO 120 

110 N=N:^tl6+ASC(HEXI< I, I )>-ASC( "A" )+10 

120 NEXT I 

130 F-RINT N:C=C+1 

140 A<C)=N 

150 IF 4<>-999 THEN GOTO 60 

190 REM PRINT OUT DATA LINE AT 1580 

200 GRAPHICS 0:PRINT "1500 DATA"; 

210 C=0 
220 C=C+1 

230 IF A<C)=999 THEN PRINT "999":STOP 
240 PRINT ACC);","; 

250 A(C)=0 
260 GOTO 220 

300 PRINT "PUT CORRECT NUMBER OF HEX BYT 
ES IN LIf€ 1000.":STOP :REM TRAP LINE 

999 n EXECUTION MODULE U 

1000 CLR :B‘r'TES=0 

1010 TRAP 300: DIN E$C1),EC INTCBYTES/6)+l 
) 

1030 FOR 1=1 TO BYTES 

1040 READ A:IF A>255 THEN GOTO 1060 

1050 POKE ADRCE$)+I,A 

1060 NEXT I 

1070 REM BASIC PART OF USER'S PROGRAM FO 
LLOWS 


Figure 11-1. Hexcode Loader Input Program 
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2. Now add the BASIC language part of your program starting at line 1080 in¬ 
cluding the USR function that calls the machine language subroutine. (See 
example below.) 

3. Count the total number of hex codes to be entered and enter this number on 
line 1000 when requested. If another number is already entered, simply 
replace it. 

4. Run the program and enter the hexadecimal codes of the machine level 

subroutine pressing after each entry. After the last entry, type 

DONE and press l:Uill;l.'l . 

5. Now the DATA line (1500) displays on the screen. It will not be entered into 

the program until the cursor is moved to the DATA line and is 

pressed. 

6. Add a program line 5 GOTO 1000 to bypass the hexcode loader (or delete the 
hexcode loader through line 260). Now save the completed program by 
using CSAVE or SAVE. It is important to do this before executing the part of 
the program containing the USR call. A mistake in a machine language 
routine may cause the system to crash. If the system does hang up, press 

. If the system doesn’t respond, turn power off and on again, 
reload the program, and correct it. 


Xote: This method only works with relocatable machine language routines. 


The following two sample programs can each be entered into the Hexcode 
Loader program. The first program prints NOTHING IS MOVING while the 
machine program changes the colors. The second sample program displays a 
BASIC graphics design, then changes colors. 


1080 GRAPHICS 1+16 
1090 FOR 1=1 TO 6 

1100 PR I NT #6 ;" no t k i re i s iYiov ire!" 
1110 F’RINT #6; "NOTHING IS NOUINGI" 
1120 PRINT #6j "riotkiris is ivioyire!" 
1130 F’RINT #6; "NOTHING IS rWING!" 
1140 NEXT I 
1150 Q=USR<ADR(EI)+1> 

1160 FOR 1=1 TO 25 NOT I = GOTO 1150 


After entering this program, check that line 1000 reads: 

1000 CLR:BYTES = 21 


Type RUN EaJJJJJJI. 
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Now enter the hexadecimal codes as shown column by column. 


68 

2 

A2 

E8 

0 

EO 

AC 

3 

C4 

90 

2 

F5 

BD 

8C 

C5 

C7 

2 

2 

9D 

C4 

60 


BYTES = 21 


When completed, type DONE and press 
last entry (999) on the DATA line and press] 


Now place the cursor after the 


Now run the program by typing GOTO 1000 and pressing CJaJJJjJJI, or if line 5 
has been added, type RUN USJmjJI. Press 1 hIJJM to stop program and delete line 
5. 


The second program, which fbllows, should be entered in place of the 

NOTHING IS MOVING program. Be sure to check the BYTES ■*_count in 

line 1000. Follow steps 2 through 6. 


1080 GRAPHICS 7+16 
1090 SETCOLOR 0.9.4 
1100 SETCiXOR 1.9.8 
1110 SETCOLOR 2.9.4 
1120 CR=1 

1130 FOR X=0 TO 159 
1140 COLOR INT<CR> 

1150 PLOT 80.0 
1160 DRAWTO X.95 
1170 CR=CR+0.125 
1180 IF CR=4 THEN CR=1 
1190 NEXT X 
1200 X=USR<ADR( Ef>+1) 

1210 FOR 1=1 TO 15 = NEXT I 
1220 GOTO 1200 


Type RUN 


RETURN 


Enter the hexadecimal codes for this program column by column. 


68 

2 

A2 

E8 

0 

EO 

AC 

2 

C4 

90 

2 

F5 

BD 

8C 

C5 

C6 

2 

2 

9D 

C4 

60 


BYTES = 21 
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when completed, type DONE and press EaSE 
last entry (999) on the DATA line and press j 


|. Now place the cursor after the 


Now run the program by typing GOTO 1000 and pressing EaJJJJJI.or add line 5 
GOTO 1000 and type RUN Press to stop program and delete line 

5. 


Figure 11-2 illustrates an assembler subroutine used to rotate colors which 
might prove useful. It is included here for the information of the user. 


Assembler Subroutine to Rotate Colors.. 


Address 

Object 

Line 

Label 

Mnemonic Data 



Code 

No. 







0100 




Routine to rotate COLOR data 



0110 




From one register to another. 



0120 




4 colors are rotated. 



0130 







0140 




Operating system address 

02C4 


0150 




COLOR 0 = $02C4 

02C5 


0160 




COLOR 1 = $02C5 

02C6 


0170 




COLOR 2 = $02C6 

02C7 


0175 




COLOR 3 = $02C7 



0180 







0190 


• _ 

$6000 

Machine program starting address* 

6000 

68 

0200 


PLA 


Pop stack (See Chapter 4) 

6001 

A200 

0210 


LDX 

/TO 

Zero the X register 

6003 

ACC402 

0220 


LDY 

COLORO 

Save COLOR 0 

6006 

BDC502 

0230 

LOOP 

LDA 

COLOR 1,X 


6009 

9DG402 

0240 


STA 

COLORO,X 


600C 

E8 

0250 


INX 


Increment the X register (add one) 

600D 

E002 

0260 


CPX 


Compare contents of X register 
with 2 

600F 

90F5 

0270 


BCC 

LOOP 

Loop if X register contents are 
less than 2 

6011 

8CC602 

0280 


STY 

COLOR3 

Save COLOR 0 in COLOR 3 

6014 

60 

0290 


RTS 


Return from machine level sub¬ 
routine 

Assembler 


This Portion is 

Source Information Programmer Enters 

Prints This 



Using Atari Assembler Cartridge 


tt Indicates data (source) 

• Routine is relocatable 
$ Indicates a hexadecimal number 


Figure 11-2. Assembler Subroutine To Rotate Colors 
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APPENDIX A 


ALPHABETICAL DIRECTORY 
OF BASIC RESERVED WORDS 


Note: The period is mandatory after all abbreviated keywords. 


RESERVED 

WORD: 

ABBREVIATION: 

BRIEF SUMMARY 

OF BASIC STATEMENT 

ABS 


Function returns absolute value (unsigned) of the 
variable or expression. 

ADR 


Function returns memory address of a string. 

AND 


Logical operator: Expression is true only if both subex¬ 
pressions joined by AND are true. 

ASC 


String function returns the numeric value of a single 
string character. 

ATN 


Function returns the arctangent of a number or expres¬ 
sion in radians or degrees. 

BYE 

B. 

Exit from BASIC and return to the resident operating 
system or console processor. 

CLOAD 

CLOA. 

Loads data from Program Recorder into RAM. 

CHR$ 


String function returns a single string byte equivalent 
to a numeric value between 0 and 255 in ATASCII code. 

CLOG 


Function returns the base 10 logarithm of an expres¬ 
sion. 

CLOSE 

CL. 

I/O statement used to close a file at the conclusion of I/O 
operations. 

CLR 


The opposite of DIM: Undimensions all strings; 
matrices. 

COLOR 

C. 

Chooses color register to be used in color graphics 
work. 

COM 


Same as DIM. 

CONT 

CON. 

Continue. Causes a program to restart execution on the 
next line following use of the key or encounter¬ 

ing a STOP. 

COS 


Function returns the cosine of the variable or expres¬ 
sion (degrees or radians). 

CSAVE 


Outputs data from RAM to the Program Recorder for 


tape storage. 
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RESERVED 

WORD; 

ABBREVIATION: 

BRIEF SUMMARY 

OF BASIC STATEMENT 

DATA 

D. 

Part of READ/DATA combination. Used to identify the 
suceeeding items (which must be separated by commas) 
as individual data items. 

DEG 

DE. 

Statement DEG tells computer to perform 
trigonometric functions in degrees instead of radians. 
(Default in radians.) 

DIM 

DI. 

Reserves the specified amount of memory for matrix, 
array, or string. All string variables, arrays, matrices 
must be dimensioned with a DIM statement. 

DOS 

DO. 

Reserved word for disk operators. Causes the menu to 
be displayed. (See DOS Manual.) 

DRAWTO 

DR. 

Draws a straight line between a plotted point and 
specified point. 

END 


Stops program execution; closes files; turns off sounds. 
Program may be restarted using CONT. (Note: END 
may be used more than once in a program.) 

ENTER 

E. 

I/O command used to store data or programs in un- 
tokenized (source) form. 

EXP 


Function returns e (2.7182818) raised to the specified 
power. 

FOR 

F. 

Used with NEXT to establish FOR/NEXT loops. In¬ 
troduces the range that the loop variable will operate in 
during the execution of loop. 

FRE 


Function returns the amount of remaining user 
memory (in bytes). 

GET 

GE. 

Used mostly with disk operations to input a single byte 
of data. 

GOSUB 

GOS. 

Branch to a subroutine beginning at the specified line 
number. 

GOTO 

G. 

Unconditional branch to a specified line number. 

GRAPHICS 

GR. 

Specifies which of the eight graphics modes is to be 
used. GR.O may be used to clear screen. 

IF 


Used to cause conditional branching or to execute 
another statement on the same line (only if the first ex¬ 
pression is true). 

INPUT 

I. 

Causes computer to ask for input from keyboard. Ex¬ 
ecution continues only when key is pressed after 

inputting data. 

INT 


Function returns the next lowest whole integer below 
the specified value. Rounding is always downward, 
even when number is negative. 

LEN 


String function returns the length of the specified str¬ 
ing in bytes or characters (1 byte contains 1 character). 
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RESERVED 

WORD: 

ABBREVIATION: 

BRIEF SUMMARY 

OF BASIC STATEMENT 

LET 

LE. 

Assigns a value to a specific variable name. LET is op¬ 
tional in Atari BASIC, and may be simply omitted. 

LIST 

L. 

Display or otherwise output the program list. 

LOAD 

LO. 

Input from disk, etc. into the computer. 

LOCATE 

LOG. 

Graphics: Stores, in a specified variable, the value that 
controls a specified graphics point. 

LOG 


Function returns the natural logarithm of a number. 

LPRINT 

LP. 

Command to line printer to print the specified message. 

NEW 


Erases all contents of user RAM. 

NEXT 

N. 

Causes a FOR/NEXT loop to terminate or continue 
depending on the particular variables or expressions. 
All loops are executed at least once. 

NOT 


A “1” is returned only if the expression is NOT true. If 
it is true, a “0” is returned. 

NOTE 

NO. 

See DOS/FMS Manual...used only in disk operations. 

ON 


Used with GOTO or GOSUB for branching purposes. 
Multiple branches to different line numbers are possible 
depending on the value of the ON variable or expres¬ 
sion. 

OPEN 

O. 

Opens the specified file for input of output operations. 

OR 


Logical operator used between two expressions. If 
either one is true, a “1” is evaluated. A “0” results only 
if both are false. 

PADDLE 


Function returns position of the paddle game controller. 

PEEK 


Function returns decimal form of contents of specified 
memory location (RAM or ROM). 

PLOT 

PL. 

Causes a single point to be plotted at the X,Y location 
specified. 

POINT 

P. 

Used with disk operations only. 

POKE 

POK. 

Insert the specified byte into the specified memory loca¬ 
tion. May be used only with RAM. Don’t try to POKE 
ROM or you’ll get an error. 

POP 


Removes the loop variable from the GOSUB stack. Used 
when departure from the loop is made in other than 
normal manner. 

POSITION 

POS. 

Sets the cursor to the specified screen position. 

PRINT 

PR. or ? 

I/O command causes output from the computer to the 
specified output device. 
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RESERVED 

WORD; 


ABBREVIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


PTRIG 


Function returns status of the trigger button on game 
controllers. 

PUT 

PU. 

Causes output of a single byte of data from the computer 
to the specified device. 

RAD 


Specifies that information is in radians rather than 
degrees when using the trigonometric functions. 
Default is to RAD. (See DEG.) 

READ 

REA. 

Read the next items in the DATA list and assign to 
specified variables. 

REM 

R. or . 

Remarks. This statement does nothing, but comments 
may be printed within the program list for future 
reference by the programmer. Statements on a line that 
starts with REM are not executed. 

RESTORE 

RES. 

Allows DATA to be read more than once. 

RETURN 

RET. 

RETURN from subroutine to the statement immediate¬ 
ly following the one in which GOSUB appeared. 

RND 


Function returns a random number between 0 and 1, 
but never 1. 

RUN 

RU. 

Execute the program. Sets normal variables to 0, un¬ 
dims arrays and string. 

SAVE 

S. 

I/O statement causes data or program to be recorded on 
disk under filespec providea with SAVE. 

SETCOLOR 

SE. 

Store hue and luminance color data in a particular color 
register. 

SGN 


Function returns +1 if value is positive, 0 if zero, - 1 if 
negative. 

SIN 


Function returns trigonometric sine of given value 
(DEG or RAD). 

SOUND 

SO. 

Controls register, sound pitch, distortion, and volume of 
a tone or note. 

SQR 


Function returns the square root of the specified value. 

STATUS 

ST. 

Calls status routine for specified device. 

STEP 


Used with FOR/NEXT. Determines quality to be 
skipped between each pair of loop variable values. 

STICK 


Function returns position of stick game controller. 

STRIG 


Function returns 1 if stick trigger button not pressed, 0 
if pressed. 

STOP 

STO. 

Causes execution to stop, but does not close files or turn 


off sounds. 
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RESERVED 

WORD: 


ABBREVIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


STR$ 


Function returns a character string equal to numeric 
value given. For example: STR$(65) returns 65 as a 
string. 

THEN 


Used with IF: If expression is true, the THEN 
statements are executed. If the expression is false, con¬ 
trol passes to next line. 

TO 


Used with FOR as in “FOR X = 1 TO 10”. Separates the 
loop range expressions. 

TRAP 

T. 

Takes control of program in case of an INPUT error 
and directs execution to a specified line number. 

USR 


Function returns results of a machine-language 
subroutine. 

VAL 


Function returns the equivalent numeric value of a 
string. 

XIO 

X. 

General I/O statement used with disk operations (see 
DOS/FMS Manual) and in graphics work (Fill). 
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APPENDIX B 


ERROR 
CODE NO. 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 


ERROR 

MESSAGES 


ERROR CODE MESSAGE 

Memory insufficient to store the statement or the new variable name or to DIM a 
new string variable. 

Value Error: A value expected to be a positive integer is negative, a value ex¬ 
pected to be within a specific range is not. 

Too Many Variables: A maximum of 128 different variable names is allowed. 
(See Variable Name Limit.) 

String Length Error: Attempted to store beyond the DIMensioned string length. 

Out of Data Error: READ statement requires more data items than supplied by 
DATA statement(s). 

Number greater than 32767: Value is not a positive integer or is greater than 
32767. 

Input Statement Error: Attempted to INPUT a non-numeric value into a 
numeric variable. 

Array or String DIM Error: DIM size is greater than 32767 or an array/martix 
reference is out of the range of the dimensioned size, or the array/matrix or string 
has been already DIMensioned, or a reference has been made to an undimensioned 
array or string. 

Argument Stack Overflow: There are too many GOSUBs or too large an expres¬ 
sion. 

Floating Point Overflow/Underflow Error: Attempted to divide by zero or 
refer to a number larger than 1 x 10®* or smaller than 1x10- 

Line Not Found: A GOSUB, GOTO, or THEN referenced a non-existent line 
number. 

No Matching FOR Statement; A NEXT was encountered without a previous 
FOR, or nested FOR/NEXT statements do not match properly. (Error is reported at 
the NEXT statement, not at FOR). 

Line Too Long Error: The statement is too complex or too long for BASIC to 
handle. 

GOSUB or FOR Line Deleted: A NEXT or RETURN statement was encountered 
and the corresponding FOR or GOSUB has been deleted since the last RUN. 
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ERROR 
CODE NO. 


ERROR CODE MESSAGE 


16 RETURN Error: A RETURN was encountered without a matching GOSUB. 

17 Garbage Error: Execution of'“garbage” (bad RAM bits) was attempted. This error 
code may indicate a hardware problem, but may also be the result of faulty use of 
POKE. Try typing NEW or powering down, then re-enter the program without 
any POKE commands. 

18 Invalid String Character: String does not start with a valid character, or string 
in VAL statement is not a numeric string. 

Note: The following are INPUT/OUTPUT errors that result during the use of disk 

drives, printers, or other accessory devices. Further information is pro¬ 
vided with the auxiliary hardware. 

19 LOAD program Too Long: Insufficient memory remains to complete LOAD. 

20 Device Number Larger than 7 or Equal to 0. 

21 LOAD File Error: Attempted to LOAD a non-LOAD file. 

128 BREAK Abort: User hit key during I/O operation. 

129 lOCB* already open. 

130 Nonexistent Device specified. 

131 lOCB Write Only. READ command to a write-only device (Printer). 

132 Invalid Command: The command is invalid for this device. 

133 Device or File not Open: No OPEN specified for the device. 

134 Bad lOCB Number: Illegal device number. 

135 lOCB Read Only Error: WRITE command to a read-only device. 

136 EOF: End of File read has been reached. [NOTE: This message may occur when 
using cassette files.) 

137 Truncated Record: Attempt to read a record longer than 256 characters. 

138 Device Timeout. Device doesn’t respond. 

139 Device NAK: Garbage at serial port or bad disk drive. 

140 Serial bus input framing error. 

141 Cursor out of range for particular mode. 

142 Serial bus data frame overrun. 

*IOCB refers to Input/Output Control Block. The device number is the same as the lOCB number. 
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ERROR 
CODE NO. 

143 

144 

145 

146 

147 
160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 


ERROR CODE MESSAGE 

Serial bus data frame checksum error. 

Device done error (invalid “done” byte): Attempt to write on a write-protected 
diskette. 

Read after write compare error (disk handler) or bad screen mode handler. 
Function not implemented in handler. 

Insufficient RAM for operating selected graphics mode. 

Drive number error. 

Too many OPEN files (no sector buffer available). 

Disk full (no free sectors). 

Unrecoverable system data I/O error. 

File number mismatch: Links on disk are messed up. 

File name error. 

POINT data length error. 

File locked. 

Command invalid (special operation code). 

Directory full (64 files). 

File not found. 

POINT invalid. 
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9 EQ a O Q Q 





39 

27 

5 

55 

37 

7 

71 

47 

G 

40 

28 

( 

56 

38 

8 

72 

48 

H 

41 

29 

) 

57 

39 

9 

73 

49 

I 

42 

2A 

♦ 

58 

3A 

; 

74 

4A 

J 

43 

2B 

+ 

59 

3B 

9 

75 

4B 

K 

44 

2C 

> 

60 

3C 

< 

76 

4C 

L 

45 

2D 

- 

61 

3D 

= 

77 

4D 

M 

46 

2E 

• 

62 

3E 

> 

78 

4E 

N 

47 

2F 

/ 

63 

3F 

9 

79 

4F 

O 

48 

30 

0 

64 

40 

@ 

80 

50 

P 

49 

31 

1 

65 

41 

A 

81 

51 

Q 

50 

32 

2 

66 

42 

B 

82 

52 

R 

51 

33 

3 

67 

43 

C 

83 

53 

S 

52 

34 

4 

68 

44 

D 

84 

54 

T 

53 

35 

5 

69 

45 

E 

85 

55 

U 

54 

36 

6 

70 

46 

F 

86 

56 

V 
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. 

A / 


/ 

231 

E7 

240 

FO 

232 

E8 

241 

FI 

233 

E9 

242 

F2 

234 

EA 

243 

F3 

235 

EB 

244 

F4 

236 

EC 

245 

F5 

237 

ED 

246 

F6 

238 

EE 

247 

F7 

239 

EF 

248 

F8 




See Appendix H for a user program that performs decimal/hexadecimal conversion. 


Notes: 

1. ATASCII stands for “ATARI ASCII”. Letters and numbers have the same values as those in ASCII, but 
some of the special characters are different. 

2. Except as shown, characters from 128-255 are reverse colors of 1 to 127. 

3. Add 32 to upper case code to get lower case code for same letter. 

4. To get ATASCII code, tell computer (direct mode) to PRINT ASC (“_”) Fill blank with letter, 

character, or number of code. Must use the quotes! 

5. On pages C-1 and C-3, the normal display keycaps are shown as white sym¬ 
bols on a black background; on pages C-4 and C-6 inverse keycap symbols 
are shown as black on a white background. 
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APPENDIX D 


ATARI 400/800 
MEMORY MAP 



ADDRESS 

CONTENTS 


Decimal 

Hexadecimal 



65535 

57344 

FFFF 

EOOO 

OPERATING SYSTEM ROM 


57343 

55296 

DFFF 

D800 

FLOATING POINT ROM 


55295 

53248 

D7FF 

DOOO 

HARDWARE REGISTERS 


53247 

49152 

CFFF 

COOO 

NOT USED 


49151 

BFFF 

CARTRIDGE SLOT A 


40960 

AOOO 

(may be RAM if no A or B cartridge) 

40959 

9FFF 

CARTRIDGE SLOT B 

(may be RAM if no B cartridge) | 


32768 

8000 

RAMTOP (MSB) 






32767 

7FFF 

(7FFF if 32K system) 

DISPLAY DATA (size varies) 



31755 

7CIF 

DISPLAY LIST (size varies) 

(7C1F if 32K system, (GRAPHICS 0) 


OS MEMTOP 



FREE RAM 




(size varies) ^ 

BASIC MEMTOP 



BASIC program, buffers, tables, run-time stack. 



(2A80 if DOS, may vary) 

OS MEMLO 

10880 

2A80 






L BASIC LOMEM 

10879 

2A7F 

DISK OPERATING SYSTEM (2A7F-700) 



DISK I/O BUFFERS (current DOS) 


9856 

2680 



9855 

267F 

DISK OPERATING SYSTEM RAM (current DOS) 

4864 

1300 
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ADDRESS 


CONTENTS 


Decimal 

Hexadecimal 


4863 

1792 

12FF 

700 

FILE MANAGEMENT SYSTEM RAM (current DOS) 

1791 

6FF 

FREE RAM 

1536 

600 


1535 

1406 

5FF 

57E 

FLOATING POINT (used by BASIC) 

1405 

57D 


BASIC CARTRIDGE 

1152 

480 


1151 

1021 

47F " 

3FD J 

OPERATING SYSTEM RAM (47F-200) 

CASSETTE BUFFER 

1020 

3FC 

RESERVED 

1000 

3E8 

999 

3E7 


PRINTER BUFFER 

960 

3C0 


959 

3BF 1 

lOCB’s 

832 

340 -1 

831 

512 

33F 1 

200 J 

MISCELLANEOUS OS VARIABLES 

511 

256 

IFF 

100 

HARDWARE STACK 

255 

FF 

PAGE ZERO 



FLOATING POINT (used by BASIC) 

212 

D4 


211 

210 

D3 

D2 

BASIC or CARTRIDGE PROGRAM 

209 

D1 


208 

DO 

FREE BASIC RAM 

207 

CF 

FREE BASIC AND ASSEMBLER RAM 

203 

CB 



202 

CA 

176 

BO 

128 

80 


FREE ASSEMBLER RAM 


ASSEMBLER ZERO PAGE f 


BASIC 

ZERO PAGE 


127 7F 

0 0 


OPERATING SYSTEM RAM 


As the addresses for the top of RAM, OS, and BASIC and the ends of OS and BASIC vary according to the 
amount of memory, these addresses are indicated by pointers. The pointer addresses for each are defined 
in Appendix I. 
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APPENDIX E 


DERIVED 

FUNCTIONS 


Derived Functions 


Derived Functions in Terms of Atari Functions 


Secant 
Cosecant 
Inverse Sine 
Inverse Cosine 
Inverse Secant 
Inverse Cosecant 
Inverse Cotangent 
Hyperbolic Sine 
Hyperbolic Cosine 
Hyperbolic Tangent 
Hyperbolic Secant 
Hyperbolic Cosecant 
Hyperbolic Cotangent 
Inverse Hyperbolic Sine 
Inverse Hyperbolic Cosine 
Inverse Hyperbolic Tangent 
Inverse Hyperbolic Secant 
Inverse Hyperbolic Cosecant 
Inverse Hyperbolic Cotangent 


SEC(X)=l/COS(X) 

CSC(X)=1/SIN(X) 

ARCSIN(X) = ATN(X/SQ,R(-X*X +1)) 

ARCCOS(X) = - ATN(X/SQ,R( - X*X + 1) + CONSTANT 

ARSEC(X) = ATN(SQR(X*X-1)) + (SGN(X-l)*CONSTANT 

ARCCSC(X) = ATN(1/SQR(X*X-1)) + (SGNlX-D’CONSTANT 

ARCCOT(X) = ATN(X) + CONSTANT 

SINH(X) = (EXP(X)-EXP(-X))/2 

COSH(X) = (EXP(X) + EXP(-X))/2 

TANH(X) = -EXP(-X)/(EXP(X) + EXP(-X))*2 +1 

SECH(X) = 2/(EXP(X) + EXP(-X)) 

CSCH(X) = 2/(EXP(X)-EXP(-X)) 

COTH(X) = EXP(-X)/(EXP(X)-EXP(-X))’2 + 1 
ARCSINH(X) = LOG(X + SQR(X*X +1)) 

ARCCOSH(X) + LOG(X + SQR(X*X-1)) 

ARCTANH(X) = LOG((l + X)/(l-X))/2 
ARCSECH(X) = LOG({SQ,R(-X*X + 1) + 1)/X) 

ARCCSCH(X) = LOG((SGN(X)*SQR(X*X + 1) + 1)/X) 
ARCCOTH(X) = LOG{{X + l)/(X-l))/2 


Xotea: 

1. If in RAD (default) mode, constant = 1.57079633 
If in DEG mode, constant = 90. 

2. In this chart, the variable X in parentheses represents the value or expression to be evaluated by the 
derived function. Obviously, any variable name is permissible, as long as it represents the number or 
expression to be evaluated. 
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Notes 


APPENDIX F 


PRINTED VERSIONS 
OF CONTROL CHARACTERS 


The cursor and screen control characters can be placed in a string in a program or used as a Direct mode 
statement by pressing the key before entering the character from the keyboard. This causes the 
special symbols which are shown below to be displayed. (Refer to Section 1 - Key.) 


PRESS 



PRESS 



SEE THIS 


PRESS 


PRESS AND 

HOLD PRESS 
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Notes 



APPENDIX G 


GLOSSARY 


Alphanumeric: 

Array: 


ATASCII: 

BASIC: 


Binary: 


Bit: 


Branch: 


Bug: 

Byte: 

Central Processing 
Unit (CPU): 


Code: 

Command: 


The alphabetic letters A-Z, the numbers 0-9, and some symbols. (No 
punctuation marks or graphics symbols). 

A list of numerical values stored in a series of memory locations 
preceded by a DIM statement. May be referred to by use of an array 
variable, and its individual elements are referred to by subscripted 
variable names. 

Stands for Atari American Standard Code for Information Inter¬ 
change. 

High level programming language. Acronym for Beginner’s All¬ 
purpose Symbolic Intruction Code. BASIC is always written using all 
capital letters. Developed by Mssrs. Kemeny and Kurtz at Dartmouth 
College in 1963. 

A number system using the base two. Thus the only possible digits 
are 0 and 1, which may be used in a computer to represent true and 
false, on and off, etc. 

Short for Binary Digit. A bit can be thought of as representing true or 
false, whether a circuit is on or off, or any other type of two- 
possibility concept. A bit is the smallest unit of data with which a 
computer can work. 

Atari BASIC executes a program in order of line numbers. This ex¬ 
ecution sequence can be altered by the programmer, and the pro¬ 
gram can be told to skip over a certain number of lines or return to a 
line earlier in the program. This contrived change in execution se¬ 
quence is called “branching”. 

A mistake or error usually in the program or “software”. 

Usually eight bits (enough to represent the decimal number 255 or 
11111111 in binary notation). A byte of data can be used to represent 
an ATASCII character or a number in the range of 0 to 255. 

In microcomputers such as the Atari systems, these are also called 
microprocessors or MPU. At one time, the CPU was that portion of 
any computer that controlled the memory and peripherals. Now the 
CPU or MPU is usually found on a single integrated circuit or “chip” 
(in Atari’s case a 6502 microprocessor chip). 

Instructions written in a language understood by a computer. 

An instruction to the computer that is executed immediately. A good 
example is the BASIC command RUN. (See Statement.) 
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Computer: 


Concatenation: 

Control Characters: 

CRT: 

Cursor: 

Data: 

Debug: 

Default: 

Digital: 

Diskette: 


DOS: 

Editing: 

Execute: 

Expression: 

Format: 
Hard Copy: 


Any device that can receive and then follow instructions to 
manipulate information. Both the instructions and the information 
may be varied from moment to moment. The distinction between a 
computer and a programmable calculator lies in the computer’s abili¬ 
ty to manipulate text as well as numbers. Most calculators can only 
handle numbers. 

The process of joining two or more strings together to form one 
longer string. 

Characters produced by holding down the key labeled tSTW while 
simultaneously pressing another key. 

Abbreviation for “cathrode ray tube” (the tube used in a TV set). In 
practice, this is often used to describe the television receiver used to 
display computer output. Also called a “monitor”. 

A square displayed on the TV monitor that shows where the next 
typed character will be displayed. 

Information of any kind. 

The process of locating and correcting mistakes and errors in a pro¬ 
gram. 

A mode or condition “assumed” by the computer until it is told to do 
something else. For example, it will “default” to screen and keyboard 
unless told to use other I/O devices. 

Information that can be represented by a collection of bits. Virtually 
all modern computers, especially microcomputers, use the digital ap¬ 
proach. 

A small disk. A record/playback medium like tape, but made in the 
shape of a flat disk that is placed inside a stiff envelope for protection. 
The advantage of the disk over cassette or other tape for memory 
storage is that access to any part of the disk is virtually immediate. 
The Atari 800 Personal Computer System can control up to 4 diskette 
drive peripherals simultaneously. In this manual, disk and diskette 
are used interchangeably. 

Abbreviation for “disk operating system”. The software or pro¬ 
grams which facilitate use of a disk-drive system. DOS is pronounced 
either “dee oh ess” or “doss”. 

Making corrections or changes in a program or data. 

To do what a command or program specifies. To RUN a program or 
portion thereof. 

A combination of variables, numbers, and operators (like +, -, etc.) 
that can be evaluated to a single quantity. The quantity may be a 
string or a number. 

To specify the form in which something is to appear. 

Printed output as opposed to temporary TV monitor display. 
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Hardware: 

Increment: 

Initialize: 

Input: 

Interactive: 

Interface: 

lOCB 

I/O: 


K: 

Keyword: 

Language: 

Memory: 


The physical apparatus and electronics that make up a computer. 

Increase in value (usually) by adding one. Used a lot for counting (as 
in counting the number of repetitions through a loop). 

Set to an initial or starting value. In Atari BASIC, all non-array 
variables are initialized to zero when the command RUN is given. Ar¬ 
ray and string elements are not initialized. 

Information transfer to the computer. Output is information transfer 
away from the computer. In this manual, input and output are 
always in relation to the computer. 

A system that responds quickly to the user, usually within a second 
or two. All personal computer systems are interactive. 

The electronics used to allow two devices to communicate. 

Input/Output Control Block. A block of data in RAM that tells the 
Operating System the information it needs to know for an I/O opera¬ 
tion. 

Short for input/output, I/O devices include the keyboard, TV 
monitor, program recorder, printer, and disk drives. 

Stands for “kilo” meaning “times 1000”. Thus 1 KByte is (approx¬ 
imately) 1000 bytes. (Actually 1024 bytes.) Also, the device type code 
for the Keyboard. 

A word that has meaning as an instruction or command in a com¬ 
puter language, and thus must not be used as a variable name or at 
the beginning of a variable name. 

A set of conventions specifying how to tell a computer what to do. 

The part of a computer (usually RAM or ROM) that stores data or in¬ 
formation. 


Menu: 


A list of options from which the user may choose. 


Microcomputer: 

Monitor: 

Null String: 

OS: 

Output: 

Parallel: 

Peripheral: 


A computer based on a microprocessor chip; in Atari’s case, the 6502. 
The television receiver used to display computer output. 

A string consisting of no characters whatever. 

Abbreviation for Operating System. This is actually a collection of 
programs to aid the user in controlling the computer. Pronounced 
“oh ess”. 

See I/O. 

Two or more things happening simultaneously. A parallel interface, 
for example, controls a number of distinct electrical signals at the 
same time. Opposite of serial. 

An I/O device. See I/O. 
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Pixel: 

Precedence: 

Program: 

Prompt: 

RAM: 

Random Number 
Generator: 

Reserved Word: 


Picture Element. One point on the screen display. Size depends on 
graphics mode being used. 

Rules that determine the priority in which operations are conducted, 
especially with regard to the arithmetical/logical operators. 

A sequence of instructions that describes a process. A program must 
be in the language that the particular computer can understand. 

A symbol that appears on the monitor screen that indicates the com¬ 
puter is ready to accept keyboard input. In Atari BASIC, this takes the 
form of the word “READY”. A “?” is also used to prompt a user to 
enter (input) information or take other appropriate action. 

Random Access Memory. The main memory in most computers. 
RAM is used to store both programs and data. 

May be hardware (as is Atari’s) or a program that provides a num¬ 
ber whose value is difficult to predict. Used primarily for decision¬ 
making in game programs, etc. 

See Keyword. 


ROM: 


Save: 


Screen: 

Serial: 


Software: 


Read Only Memory. In this type of solid-state electronic memory, in¬ 
formation is stored by the manufacturer and it cannot be changed by 
the user. Programs such as the BASIC interpreter and other car¬ 
tridges used with the Atari systems use ROM. 

To copy a program or data into some location other than RAM (for ex¬ 
ample, diskette or tape). 

The TV screen. In Atari BASIC, a particular I/O device codes “S:” 

The opposite of parallel. Things happening only one at a time in se¬ 
quence. Example: A serial interface. 

As opposed to Hardware. Refers to programs and data. 


Special Character: 


Statement: 


String: 


Subroutine: 


Variable: 


Window: 


A character that can be displayed by a computer but is neither a let¬ 
ter nor a numeral. The Atari graphics symbols are special characters. 
So are punctuation marks, etc. 


An instruction to the computer. See also Command. While all com¬ 
mands may be considered statements, all statements are certainly not 
commands. A statement contains a line number (deferred mode), a 
keyword, the value to be operated on, and the BaESS command. 


A sequence of letters, numerals, and other characters. May be stored 
in a string variable. The string variable’s name must end with a $. 


A part of a program that can be executed by a special statement 
(GOSUB) in BASIC: This effectively gives a single statement the power 
of a whole program. The subroutine is a very powerful construct. 


A variable may be thought of as a box in which a value may be 
stored. Such values are typically numbers and strings. 


A portion of the TV display devoted to a specific purpose such as for 
graphics or text. 
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APPENDIX H 


USER 

PROGRAMS 


This appendix contains programs and routines that demonstrate the diverse 
capabilities of the Atari Personal Computer System. Included in this appendix is 
a Decimal/Hexadecimal program for those users who write programs that re¬ 
quire this type of conversion. 


CHECKBOOK 

BALANCER 


This is one of the “traditional” programs that every beginning computerist 
writes. It allows entry of outstanding checks and uncredited deposits as well as 
cleared checks and credited deposits. 

10 Din A$-:30),nSG$<40).nSGl$(30>.n3G2t(3 
0nSG3f< 30MSG4$(30nSG5$< 30 nSGb$(3 
0) 

20 OUTSTHm=0 

30 GRAPHICS 0=? =? " CHECKBOOK BALAH 
CER"=? 

40 ? "You lYiay iTiake correct-ions at any ti 
me by enterins a nesatiue dollar ualue. 

11 

50 nSGl$="0LD CHECK -- STILL lOUTSTAHDIHG 

II 

60 riSG2$="0LD DEPOSIT — NOT CREDITED 

II 

70 n3G3l="0LD CHECK — X'ST CLEARED 
11 

80 nSG4$="0LD DEPOSIT — JLST CREDITED 

II 

90 nSG5$="l€U CHECK (OR SEFlUICE CHARGE) 

II 

100 n3G6$="NEW DEPOSIT (OR INTEREST) 

II 

159 TRAP 150 = ? “Enter besinnins balarice 
from your checkbook";= INF'UT YOURBAL 

160 TRAP 160 = ? "Enter besinnins balarice 
froi'ft your bankstatement" j = Iff'IJT BANKBAL 
165 TRAP 40000 

170 GOTO 190 

180 CLOSE #1=? "PRINTER IS NOT 0PERATI0.N 
AL " 

185 ? "PLEA:5E CHECK COIMECTORS." 

190 PERM=0 

2^ ? "Would you like a permanent record 
on the printer"; =IhFLrr A$ 

210 IF LEN-(A$)=0 THEN 'm 
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220 IF THEM 400 

230 IF THEM 208 

240 TRAP 1S0 

250 LPRIf-rr :REM TEST PRINTER 
260 PERri=l 

280 LPRIHT "VIDUR BEGIMfllMG SALAICE IS f" 
^■lUIREAL 

290 LPRIHT "BAHK STATEMENT BEGIMMIf^G BAL 
ANCE IS f'NBANKBAL: LPRIHT 
400 TRAP 400:? :? "ChOOSe OnS of the fol 
lowing:" 

410 ? "(1> ";MSG1$ 

415 ? "(2> ";MSG2$ 

420 ? "(3) ";riSG3$ 

425 ? "(4) "jriSG4J 
430 ? "(5> 'NftSGSf 
435 ? "(6) ";fT3G6$ 

440 ? "(7) D0f€" 

490 ? 

500 INPUT IMF N<1 OR H>7 THEN 488 
505 TRAP 400y0 

510 ON N GOSUB 1880.2880.3888.4888.. 5808. 
6000.7080 

520 r1SG$="^£W CHECKBOOK BALANCE IS 

": AnOlJHT=YOURBAL = GOSUB 8088 

530 riSG$="lEH BANK STATEMENT BALAfCE IS 

": A}10UNT=BA1KBAL: GOSUB 8808 

540 MSG$="0UT3TAH’DIHG Cf£CKS-DEPOSITS= 

":AMOUHT=OUTSTAND:GOSUB 8088 
545 IF PERM THEN LPRIfTT 
550 GOTO 480 

1080 REM OLD CHECK - STILL OUTSTAIEUNG 
1010 MSG$=MSG1$:GOSUB 8188 
1020 OUTSTAND=OUTSTAh£+AMOUNT 
1030 RETURN 

2000 REM OLD DEPOSIT — STILL NOT CREDIT 
ED 

2010 MSG$=MSG2$:GOSUB 8188 
2020 0UT3TAfCi=0UTSTAND-AMiDLlNT 
2030 RETURN 

3000 REM OLD CHECK - JUST CLEARED 
3010 MSG$=MSG3$:GOSUB 8188 
3020 BANKBAL=BANKBAL-AMCiUNT 
3030 RETURN 

4000 REM aO DEPOSIT -- JUST CREDITED 
4010 MSGI=M3G4$:GOSUB 8188 
4020 BANKBAL=BAhKBAL+AMOUNT 
4030 RETURN 

5000 REM NEW CHECK COR SERUICE CHARGE) - 
- JUST aEARED 
5010 f1SG$=M:BiG5$: GOSUB 3138 
5020 YOURBAL=YOURBAL-AMOUNT 
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5030 ? "IS NEW CHECK STILL OUTSlHmiNi:"; 

: INPUT m 

5040 IF LEN<:A$)=0 then 5030 
5050 IF AI<1,1X>"N" Th€N 5860 
5055 E!ANKBhL=BANKBAL-AM!:iUNT 

5057 IF PERM THEN LPRirTT "CHECK HAS CLEA 
RED." 

5058 RETURN 

5060 IF A$(1,1X>"Y" THEN 5038 
5070 OUTSTA^O=OUTSTAND+AMOUNT 
5075 IF PERM THEN LPRINT "CHECK IS STILL 
OUTSTANDIf$:." 

5080 RETURN 

6000 REM NEW DEPOSIT (OR INTEREST) — JU 
ST CREDITED 

6010 riSG^=MSG6f:G0SUe 8100 

6020 YOURBAL=VOUF;BAL+AMOUNT 

6030 ? "HAS YOUR NEW DEF'OSIT BEEN CREDIT 

ED"; :IhFUT AJ 

6040 IF LElKAf )=0 THEN 6038 
6050 IF A$(1.1X>"Y" THEN 6069 

6052 BANKBAL=BANK:BAL+AM!j!JNT 

6053 IF PERM THEN LPRINT "DEPOSIT HAS BE 
EN CREDITED." 

6055 RETURl^ 

6060 IF A$C1,1X>"N" THEN 6038 

6070 ClUTSTAND=OUTSTA10-AMOUNT 

6075 IF PERM THEN LPRINT "DEPOSIT HAS NO 

T BEEN CREDITED." 

6080 RETURN 
7000 REM DONE 

7010 ? "BANK'S BALAfCE MINUS (OUTSTANDIN 
G CHECKS-DEP0SIT3) SHOULD NOW EQUAL 
YOURCHECKBOOK BALANCE." 

7020 DIF=Y0UF'BAL-;BAN1:BAL-0UTSTAND ) 

7030 IF DIFO0 THEN 7849 

7035 ? "IS f";BANKBAL;" THE ENDING BALAN 
CE ON YOUR BAhK STATEfCNT"; = INPUT Al 

7036 IF LB+;Af)=0 THEN 7835 

7037 IF A$(1,1)="Y" THEN ? "COIGRATULATI 

ONS: YOUR CHECKBOOK BALANCES!"=END 


7038 GOTO 7060 

7040 IF DIF>0 THEN ? "YOUR CHECKBOOK TOT 
AL IS l";DIF;" OUER YOUR: BANK'S TOTAL. " 
:GOTO 7060 

7050 ? "YOUR checkbook; TOTAL IS $";-OIF; 
" UNDER ■-.'OUR BANK'S TOTAL." 

7060 ? "WOULD YOU LIKE TO MAKE CORRECTIO 
NS?" 

7070 ? "REMEMBER. YOU CAN ENTER A ^£GATI 
UE DOLLAR UALUE TO MAKE A CORRECTION. 
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7080 ? "ENTER Y OR H"; = nRiT h$ 

7090 IF LeKH$>=0 THEiN BC 
7100 IF AI(1.1)="Y" THEN RETURN 
7110 B€ 

7999 Rtn MSG PRINTIN': ROUTI^£ 

8000 ? MSGI;" $";HmUNT 

8010 IF F'ERM=1 THEN LPRINT MSG$/' 

UNT 

8020 RETURN 

8100 REM MSG PRINT IhFUT ROUTIhC 
8110 TRAP 8110=? "ENTER AMOUNT FOR ";MSG 
I; •• INPUT AMOUNT 
8120 TRAP 40000 

8130 IF FERM=1 THEN LPRINT MSG#;" #";AMO 
UNT 

8140 RETURN 
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BUBBLE SORT 




This program uses the string comparison operator “<= ” that orders strings ac¬ 
cording to the ATASCII values of the various characters. Since Atari BASIC does 
not have arrays of strings, all the strings used in this program are actually 
substrings of one large string. A bubble sort, though relatively slow if there are 
a lot of items to be stored, is easy to write, fairly short, and simpler to under¬ 
stand than more complex sorts. 


10 DIM Bl<1> 

20 GRAPHICS 0:? =? " STRING SO 

RT":? 

30 TRAP 30;? :? "Enter liiaxiniUiTi strire 1e 
netH";=INPUT SLEN;SLEN1=SLEN-1 
35 IF SLENCl OR INT<SLENX>SLEN THEN ? " 
F1 EA.se enter a P0SITIi.,.€ integer > 0.";GO 
TO 30 

40 TRAP' 40;? =? "Enter iTiaxinHjift nuriiber of 
eritries." 

41 ? "(Entries which are shorter tkan th 
e iViaxiiiMii will be eadded with blank's. ) 

11 


42 INPUT ENTRIES 

45 IF ENTRIES<2 OR INT(ENTRIES><>ENTRIES 
THEN ? "PLEASE ENTER A POSITIUE INTEGER 
> l.";G0T0 40 
47 TRAP 40000 

50 DIM A$(SLEN:^ENTRIES).TEMPf(SLEN> 
b0 ? :? "Enter strinss one at a tiine." 

70 ? "Enter en'irta strins when done (Just 


hitRETURN)." 

75 ? ;? "PLEASE STAND BY WHILE 
GS ARE BEII-l!: CLEARED. . 


FHE STRIN 


80 FOR 1=1 TO SLEN*ENTRIES;A$( LI)=" ";N 


EXT I 
85 ? ;? 

90 1=1 

100 FiDR .J=l TO ENTRIES 

110 ? INPUT TEMPI 

120 IF LEIK TEMPI)=0 THEN ENTRIE3=J-1^GOT 

0 190 

130 Al(LI+SLENl)=T£MPI 
140 I=I+SLEN 
150 NDT J 

190 ? :? :? "FlEASE STAIC &7 WHILE THE S 

TRINGS ARE BEING SORTED 

200 GOSUB 1000;REM CALL SORT ROUTINE 

202 ? :? 

205 1=1 

210 FiDR K=1 TO ENTRIES 
220 ? ’kAK L I+SLENl > 

225 I=I+SLEN 
230 NEXT K 

240 TRAP' 300;? ;? "WOLD YOU LIKE A PRIN 
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TED COPY";:INPUT bJ 

250 IF TF€N 400 

300 END 

400 I=1:LPRINT :FOR K=1 TO ENTRIES 
420 LPRINT "r;K;" L I+SLEHl ) 

430 I=I+3LEfI:h€XT K^END 

1000 REM STRING BUBBLE SORT ROUTINE 

1010 R£M IhPiJT: AfuSLEN. ENTRIES 

1015 REM TEMPI MUST HAUE A DIMENSION OF 

SLEN. 

1020 SLEN1=3LEN-1 = MAN=SLEN‘;:lc(ENTRIES-1 >+l 

1040 FOR 1=1 TO MAX STEP SLEN 
1050 D0NE=1 

1060 FOR K=1 TO MAX-I-SLENl STEP SLEN 
1070 KSLEN1=K+SLEN1: KSLEN=K+SLEfH' ^ KSLENSL 
EN1=K3LEN+SLEN1 

1080 IF Hl<K.KSLENlK=AI'::K:3LEN,KSLa6LEN 
1) THEN GOTO 1110 
1090 DONE=0 

1100 TB1F’$=A$< K, KSLENl) = A$( K. KSLENl )=Af( 
KSLEN> KSLEISLENI) = A$(KSLEN.KSLENSLEIU )=T 
EMPI 

1110 NEXT K 

1120 IF DONE THEN RETURN 
1130 NEXT I 
1140 RETURN 
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TEXT MODES 
CHARACTER 
PRINT 


This program prints the Atari characters in their default colors for text modes 
0, 1, and 2. In entering this program, remember that the clear screen symbol 
is printed as “ } 


1 DIN 1> 

5 ? "}"=REM CLEAR SCREEN 

10 ? "GRAPHICS 0. L Am 2 (TEXT NODES)" 

20 ? "DEnOHSTRATION." 

30 ? "DISPLAYS CHARACTER SETS FOR EACH N 
ODE." 

60 NAIT=1000^REN SUBROUTINE LINE NUNBER 
70 CHBAS=756:R£N CHARACTER BASE ADDRESS 
80 UPPER=224:REN DEFAULT FOR CHBAS 
90 L0W£R=226:REN LOWER CASE LETTERS & GR¬ 
APH ICS 

95 GOSLIB WAIT 

100 FOR L=0 TO 2 

112 REN USE E= FOR GRAPHICS 0 

115 IF L=8 THEN OPEN #C8.0/'E:" =GOTO 11 
8 

116 REN USE S= FOR GRAPHICS 1 Al'ID 2 

117 OPEN #C8.0/'S = " 

118 GRAPHICS L 

120 PRINT "t3^:APHICS ".;L 
130 FOR J=8 TO 7=REM 8 LINES 
140 FOR 1=0 TO 31= REM 32 CHARS-'LINE 
150 K=32:?:J+I 

155 REM DaPT DISPLAY "CLEAR SCREEN" OR 
"RETURN" 

160 IF K=ASC("}") OR K=155 THEN 1S0 

165 IF L=0 THEN PUT #LASC(" "):REM ESCA 

PE 

170 PUT #LK = REM DISPLAY CHARS 
180 NEXT I 

190 PRINT #1;" " = REM BD OF LI.NE 
200 IF L02 OR J03 THEN 248 
210 REN SCREEN FULL 
220 GOSUB WAIT 

230 PRINT #1;"}":R£M CLEAR SCREEN 
240 NEXT J 
250 GOSLIB WAIT 

265 PRINT "LOi-£R CASE AND GRAPHICS" 

270 IF LO0 THEN POKE CHEiAS.. LOWER mX'SUB 
WAIT 

275 CLOSE #1 

280 NEXT L 

300 GRAPHICS O-END 

1000 R£M WAIT FOR "RETURN" 

1010 PRINT "HIT RETURN TO CONTINUE".: 

1020 INPUT Al 
1030 RETURN 
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LIGHT SHOW 


This program demonstrates another aspect of Atari graphics. It uses graphics 
mode 7 for high resolution and the PLOT and DRAWTO statements to draw the 
lines. In line 20, the title will be more effective if it is entered in inverse video 
(use the Atari logo key). 

10 FOR ST=1 TO 8=GRAPHICS 7 
15 POKE 752.1 

20 ? :? " Atari's Special Lisht Sl-.ow 

":SETC0L0R 2.0.0 

30 SETCOLOR l.ZtST.S^COLOR 2 

40 FOR DR=0 TO 80 STEP ST 

50 PLOT 0.0=DRAWTO 100.DR 

60 NEXT DR TOR N=1 TO 800 = NEXT N = NEXT ST 

70 FOR N=1 TO 2000=NEXT N=G0T0 10 
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UNITED STATES 
FLAG 


This program involves switching colors to set up the stripes. It uses graphics 
mode 7 plus 16 so that the display appears as a full-screen. Note the cor¬ 
respondence of the COLOR statements with the SETCOLOR statements. For fun 
and experimentation purposes, add a SOUND statement and use a READ/DATA 
combination to add “The Star Spangled Banner” after line 470. (Refer to Section 
10 .) 


10 REM DRAW THE UNITED STATES FLAG 
20 REM HIGH RESOLUTION 4-COLOR GRAPHICS. 
NO TEXT WINDOW 

7ft rPiiPWTrc '7+ii: 

40 REM SETCOLOR 0 CORRESPONDS TO COLOR 1 

50 SETCOLOR 0.4.4^RED=1 

60 REM SETCOLOR 1 CORRESPONDS TO COLOR 2 

70 SETCOLOR 1.0.14a.lHITE=2 

80 REM SETCOLOR 2 CORRESPONDS TO COLOR 3 

90 BLUE=3:REM DEFAULTS TO BLUE 

100 REM DRAW 13 RED & WHITE STRIPES 

110 C=RED 

120 FOR 1=0 TO 12 

130 COLOR C 

140 REM EACH STRIPE HAS SEUERAL H0RI20NT 
AL LI1€S 

150 FOR J=0 TO 6 
160 PLOT 0.I^:7+J 
170 DRAWTO 159.I^:7+J 
180 NEXT J 

190 REM SWITCH COLORS 

200 C=C+1- IF OWHITE THEN C=RED 

210 NEXT I 

300 REM DRAW BLUE RECTArlTLE 

310 COLOR BLUE 

320 FOR: 1=0 TO 48 

330 PLOT 0.1 

340 DRAWTO 79.1 

.350 NEXT I 

360 REM DRAW 9 ROWS OF WHITE STARS 
370 COLOR WHITE 

380 K=0 = REM ‘oTAFvT WITH ROW OF S STARS 
390 FOR 1=0 TO 8 
395 Y=4+I:^c5 

400 FOR J=0 TO 4:REM 5 STARS IN A ROW 
410 X4;+54J:^14^G0SUB 1080 
420 NEXT J 

430 IF KO0 THEN K=0^GOTO 478 

440 REM ADD 6TH STAR ECCRV OTHER LI1€ 

450 X=5+5:n4 = G03UB 1088 
460 K=7 
470 NEXT I 

500 REM IF KEY HIT THEN STOP 
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510 IF PEEK-:; 764 )=255 THEN 510 

515 F£!1 OPEN TEKT WINDOW WITHOUT CLEARIN 

G SCREEN 

520 GRAPHICS 7+32 

525 FBI i:hani:e colors back 

530 SETuOLOR 0j4^4-b’ETCOLuR 1 j0j14 

550 STOP 

1000 REN DRAW 1 STAR CBITERED AT 
1010 PLOT X-LY-DRAWTO X+LY 
1020 PLOT X.Y-l-PLOT X.Y+1 
1030 RETURN 
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SEAGULL OVER 
OCEAN 


This program combines graphics and sounds. The sounds are not “pure” 
sounds, but simulate the roar of the ocean and the gull’s “tweet”. The graphics 
symbols used to simulate the gull could not be printed on the line printer. Enter 
the following characters in line 20. 


20 BIRDS = “ V— ” 


To get these symbols, use ISTIl G. 020 Wm R, Q20 


10 Din BIRD$(4) 

20 BIRDJ=" 

30 FLAG=1= ROW=10 = COL=10 
40 GRAPHICS l^POKE 75b; 226•• POKE 752; 1 
50 SETCOLOR 0;0;0:SETCOLOR LS.. 14 
60 PRIirr #6; " the ccean" 

70 R=IHT(RND(0vni) 

80 POSITIOH 17;17 

90 FOR T=0 TO 10 

100 SOUND 0;T;8;4 

110 FOR H=1 TO 50: NEXT A 

120 IF RND‘;:8»0.S THEN FOR D=10 TO 5 STE 

P -1: SOUND 1;0;10;INT<RND<8)^:10):NEKT D: 

SOUND 1;0;0;0 

130 GOSUB 200 

140 hOT T 

150 FOR T=10 TO 0 STEP -1 

160 SOUh€ 0;T;8;4 

170 FOR A=1 TO 50:NEXT A 

175 IF Rhffi<0)>0.S THEN FOR D=10 TO 5 STE 

P -1: SOUND 1; D; 10;8:NEKT D: SOUND 1 ; 0;0;0 

180 FOR H=1 TO 10:NENT H 

185 GOSUB 200 

190 NEXT T 

195 QjTO 70 

200 IjOSUB 300 

210 POSITIQfl COL; ROW 

220 PRINT #6;BIRnf::FLAG;FLAG+l) 

230 FLAG=FLAG+2:IF FLAG=5 THEN FLAG=1 
240 RETURN 

300 IF RND(8»0.5 THEN RETURN 
310 POSITION COL;ROW 
320 PRINT #6.1" " 

330 A=INT<RHn'0;:«3>-l 

340 B=INT(Rh€(8):^3)-l 

350 ROl'i=ROW+A 

360 IF ROW=0 THEN R0W=1 

370 IF ROW=20 THEN R0W=19 

380 COL=COL+B 

390 IF COL=0 THEN C0L=1 

400 IF CODIS THEN C0L=18 

410 RETURN 
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VIDEO 

GRAFFITTI 


This program requires a Joystick Controller for each player. Each joystick has 
one color associated with it. By maneuvering the joystick, different patterns are 
created on the screen. Note the use of the STICK and STRIG commands. 


1 GRAPHICS 0 

2 ? "UIDEO GRAFFITI" 

5 REM X!LY AFRAVS HOLD COORDINATES 

6 REM FOR UP TO 4 PLAYERS' POSITIONS. 

7 REM COLR ARRAY HOLDS COLORS. 

10 DIM AK 1 K< 3Y( 3DXRC 3) 

128 ? "USE JOYSTICKS TO DRAW PICTURES" 
123 ? "PRESS BUTTONS TO CHANiGE COLORS" 

130 ? "INITIAL COLORS’" 

131 ? ".JOYSTICK 1 IS RED" 

132 ? "JOYSTICK 2 IS WHITE" 

133 ? "JOYSTICK 3 IS BLUE" 

134 ? ".JOYSTICK 4 IS BLACK (BACKGROUf^J)" 


135 ? "BLACK LOCATION IS INDICATED BY A 
BRIEFFLASH OF RED." 

136 ? "IN GRAPHICS 8. JOYSTICKS 1 AND 3 
ARE l-WITE AND 4 IS BLUE." 

138 PRINT "HOW MANY PLAYERS Cl-4)"; 

139 INF-UT hS-I? LE1KAI>=0 THEN A$="l" 

140 .JO'’(r!AX=i...iAL(AI>-l 

145 IF JOYMAK<0 OR .J0YMAX>=4 THEN 138 
147 PRINT "GRAPHICS 3 (48X24), 5 (88X48) 

II 

150 PRINT "7 (160X36), OR 3 (323X132)"; 

152 INF'UT A$:IF LEN(A$)=0 THEN AJ="3" 

153 ) 

154 If'^A=3 then XMAX=48:YMAX=24 ’G0T0 159 


155 IF A=5 THEN XMAX=88^YMhX=48:GOTO 159 


156 IF A=7 THEN XMAX=160^YMAX=9b^G0T0 15 


157 IF A=8 THEN XMAX=3?0:YriAX= 132 = GOTO 1 
59 

158 GOTO 147=P£M A NOT UALID 

159 GRAPHICS A+16 

160 FOR 1=0 TO J0YMAX = X(I)=XMAX.-'2+I=Y(I) 
='fMAX.'”2+I=h€XT I=REM START NEAR CENTER 0 
F SCREEN 


161 IF A08 THEN 166 

162 FOR 1=0 TO 2=C0LR(I)=1=N£XT I 

163 SETCOLOR 1,9,14=REM LT. BLUE 


165 GOTO 180 

166 FOR 1=0 TO 2:C0LR(I)=!+!=NEXT I 

167 SETCOLOR 8,4,6=REM RED 

168 SETCOLOR 1,0,14 = REM WHITE 
180 CXR(3)=0 


295 FOR J=8 TO 3 
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300 FOR 1=0 TO JOYMAK^F-EM CHECK JOYSTICK 
S 

3^ REM CHECK TRIGGER 

310 IF STRIGCI) THEN 321 

311 IF A08 THEN 320 

312 COLR( I ■=COLR< I )+MF COLR< I >=2 THEN 
COLR<I )=0 = R£M 2-COLOR MODE 

313 GOTO 321 

320 COLR( I >=COLR( I )+l = IF COLR( I »=4 THEN 
COLR(I)=0:REM 4-Ci>L0R MODE 

321 IF J>0 THEN COLOR COLR( I) GOTO 325 
3^2 IF C0LR(I)=8 THEN COLOR l=GOTO 323 
323 COLOR 0:REM BLINK CURRENT SOUARE ON 
AlCi OFF 

325 PLOT .X(I>.Y(I) 

330 J0YIN=3TICK(I)=REM READ JOYSTICK 
340 IF J0YIN=15 THEN 538^REM NO MOUEMENT 

342 COLOR COLR<I):REM MAKE 3UR;E COLOR 13 
ON 

344 PLOT K(I>.Y(I) 

350 IF J0YIN>=8 THEN 330 

360 X(I>=X(I)+l:REM MOJE RIGHT 

365 REM IF OUT OF RANGE THEN WRAPAROUND 

370 IF XCI »=XMAX THEN X( I >=8 

330 GOTO 430 

390 IF J0YIN>=12 THEN 438 

400 X(I>=X<I )-l:REM MOUE LEFT 

410 IF X<IK0 THEN X(n=XMAX-l 

430 IF J0YII4(>5 AND J0YINO9 AND JOYINO 

13 THEh^ 470 

440 Y( I >=Y( I )+l = IF Y< I :i>=YMAX THEN Y( I >= 
0:REM MOUE DOWN 
460 IjOTO 500 

470 IF J0YINO6 AND J0YINO13 AlC JGYIN< 
>14 THEN 580 

480 Y( I >=Y( I >-l: IF YCIX0 THEN Y( I >=YMAX 
-1=REM MOUE UP 
500 PLOT X(I>.Y(I> 

530 ne>:t I 
535 NEXT J 
540 GOTO 295 
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KEYBOARD 

CONTROLLER 


This program alters registers on a chip called a PIA. To set these back to the 
default values in order to do further I/O, hit or POKE PACTL,60. If 

this program is to be loaded from disk, use LOAD, not RUN and wait for the 
busy light on the disk drive to go out. Do not execute the program before this 
light goes out, otherwise the disk will continue to spin. 


1 GRAPHICS 0 

5 PRINT :PRINT " KEYBOARD CONTROLLER 
DEMO" 

10 DIN ROl-K 3I$( 13 BUTTONf(1 > 

30 GOSUB 5000 
40 FOR CNT=1 TO 4 

60 POSITION 2,CNTt2+5=PRINT "CONTROLLER 
# ";CHT;":"j 
70 NEXT CNT 

80 FOR CNT=1 TO 4=GOSUB 7000:POSITION 19 
,CNT+CNT+5:PRINT BUTTON!j :f€XT CNT 
120 GOTO S0 

6000 REN n SET UP FOR CONTROLLERS U 
6010 PORTA=54016 = PORTB=54017 = PACTL=5401S 
=PBCTL=54019 

6020 POKE PACTL,43 = F'0KE PORTA. 255-POKE P 

ACTL.52:P0KE PORTA,221 

6025 POKE PBi:TL,4ST'0KE P0RTB,235T'0KE P 

BCTL,52:P0KE P0RTb,221 

6030 ROl-K 0 )=233 = ROW-:; 1 )=22 1 = FOW':; 2 )= 1 S7 = RO 

W(3)=119 

6040 I$=" 123456739:^(0#" 

6050 RETURN 

7000 REN n RETURN BUTTON! WITH CHARACTE 
R FOR BUTTON WHICH HAS BEEN PRESSED ON C 
ONTROLLER CNT (1-4). U 

7001 REN n N0TE= A 1 WILL BE RETURICD I 
F NO CONTROLLER IS CONNECTED. 

7002 FEN n A SPACE WILL BE RETURNED IF 
THE CONTROLLER IS CONiCCTED BUT NO KEY H 
AS BEEN PRESSED. U 

7003 P0RT=P0RTA:IF CNT>2 THEN P0RT=P0RTB 


7005 P=1 

7003 PA0=CNT+CNT-2 
7010 FOR J=0 TO 3 
7020 POKE PORT.ROl-KJ) 

7030 FOR 1=1 TO 10:®(T I 

7050 IF PADDLE<PAD+1)>10 THEN P=J+J+J+2: 

GOTO 7090 

7060 IF PADOLE<PhD»10 THEN P=.J+J+J+3 = GO 
TO 7090 

7070 IF STRIG(CNT-1 THEN P=.J+.J+.J+4:GO 

TO 7090 

7080 NEXT J 

7090 BIJTTill!=I$(P,P) 

7095 RETURN 
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TYPE-A-TUNE 


This program assigns musical note values to the keys on the top row of the 
keyboard. Press only one key at a time. 

KEY 


INSERT 

CLEAR 


0 
9 
8 
7 
6 
5 
4 
3 
2 
1 

10 Din CHORD'37),TUNEC12> 

20 GRAPHICS 0'? :? " TYPE-A-TUHE 

PROGRAM" 

25 ? :? "PRESS KEYS l-9.0.<;> TO PTODUCE 
NOTES"; 

27 ? "RELEASE ONE KEY BEFORE PRESSIfC TH 
E NEXT." 

28 ? "OTHERWISE THERE MAY BE A DELAY." 

30 FOR X=1 TO 37: READ A = CHORD*:; X )=A = NEXT 
X 

40 FOR X=1 TO 12: READ A: TIJNE< X ;'=A: NEXT X 

50 OPEN #L4.0/'K:" 

55 0LDCHR=-1 

60 A=PEEKX764>:IF A=255 THEN 60 
63 IF A=0LDCHR THEN 108 
65 0LDCHR=A 

70 FOR X=1 TO 12: IF TLih£<X:'=A THEN SGUNO 
0. CHORD-:; X) AO. S = GOTO 180 
80 NEXT X 

100 I=I NT< PEEK( 53775 ;)• '4 > -1F I /2 ;>= I HK I 
2) THEN 60 

110 POKE 764.255 = Si3UND 0.0.0.0:OLDCHR=-1 
:G0T0 60 

m DATA 243.238.217.204A93AS2.. 173.162 
.153.144.136.128.121.114.183.182.96.91.8 
5.81.76.72.68.64.68 

210 DATA 57.53.50.47.45.42.40.37.35.33.3 
1.29 

220 DATA 31.30.26.24.2-9.27.51.53.48.50.5 
4.55 


MUSICAL VALUE 
B 

bI» (or Ait) 

A 

Ab (or Gif) 

G 

Fit (or G b) 

F 

E 

B ^ (or D^') 

D 

ob (or Cit) 

C 


To play “Mary Had A Little Lamb” press the following keys: 


5, 3, 1, 3, 5, 5, 5 3, 3, 3 5, 8, 8 


5, 3, 1, 3, 5, 5 


5, 5, 3, 3, 5, 3, 1 
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COMPUTER 

BLUES 


This program generates random musical notes to “write” some very interesting 
melodies for the programmed bass. 


1 GRAPHICS 0:? =? " COMPUTER BLUE 

S":? 

2 PTR=1 

3 THN0T=1 

5 CH0RD=1 

6 PRINT "BASS TEMPO <l=FAST)"j 

7 INPUT TEIFO 

8 GRAPHICS 2+16^G0SUB 2800 
10 DIM BASE(:3,4> 

20 DIM LOW. 2) 

25 DIM LI1£<16) 

26 DIM JArK3.7) 

30 FOR X=1 TO 3 
40 FOR Y=1 TO 4 

50 READ A:BASE<M,Y>=A 
60 NEXT Y 
70 NEXT X 

80 FOR :>=:=! TO 3 = READ A = L0N(X ■=A 
90 NEXT X 

95 FOR X=1 TO 16 = REArj A:LINE<X:'=A:NEXT X 


96 FOR X=1 TO 3 

97 FOR Y=1 TO 7 

98 READ A:JAnCX.Y>=A:NEXT YTSXT X 
100 GttSUB 500 

110 T=T+1 
115 GOSIJB 280 
120 GOTO 100 

2’00 REM F-ROCESS HIGH STUFF 

205 IF RNO(:0)<8.25 THEN FiTURN 

210 IF RND<8K0.5 THEN 258 

220 NT=NT+1 

230 IF NT>7 THEN NT=7 

240 GOTO 260 

2'50 NT=NT-1 

255 IF NT<1 THEN NT=1 

260 S’DUND 2,JAMCCHORD,NT>,10,NT:^2 

280 RETURN 

500 REM PROCESS BA:5E STUFF 
510 IF BA25=1 THEN 708 
520 BDUR=BX'F:+1 


538 

531 

535 

540 

550 


IF BtiUROTEMPO THEN 535 

BASS=LBD:JR^0 

S0U!1D 0, LOW( CHORD); 18,4 

THNOT), 10,4 


S0!.!110 l,BA3E(CHiDR0,' 


OCTi in 

hi t oh 


700 SIB ID 0,0,0,0 


710 S'BCi 1,0,0,0 
720 B0UP=BDUR+1 
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730 

IF BOUROl 

THEN 880 

740 

BOUk- 0•BAi 

;-:=0 

758 

TrtCiT=THiir 

T+1 

760 

IF THNOTC 

5 THEN 800 

765 

TH!C'T=1 


770 

PTR=PTR+1 


780 

IF PTR=17 

THEN PTR=1 


790 CHi]RD=LINE(PTR) 

800 RETURN 

1000 DATA 162.144.136.144.121.. 10S; 102.. 10 

8.108.96.91.96 

1010 DATA 243.182.162 

1820 DATA I.I.I.I.2.2.2.2.I.1.1.1.3.2.1. 

1 

1030 DATA 68.50.47.42.40.33.29 
1040 DATA 60.50.45.42.40.33.29 
1050 DATA 81.63.64.57.53.45.40 
2000 PRINT #6^ PRINT tb-'P-RINT #6 

2005 PRINT #6.;" Coinputer" 

2006 PRINT #5 

2010 PRINT #6;" Blues" 

2030 RETURN 
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This program can be typed in and used to convert hexadecimal numbers to 
decimal numbers and vice versa. 


DECIMAL/ 

HEXADECIMAL 

CONVERSION 

PROGRAM 


10 DIM A$<9)..ADf<D 

20 GRAPHICS 0:? :? " HEK NUMBER CONU 
ERSIONS”:? 

30 ? =? "Enter 'D' for DEC to HEM conoer 
siori."^? "Enter 'H' for HEIM to DEC conoe 
r5ion."aNPUT A$ 

40 IF LEN(h^>=0 then 30 
50 IF AJ="H" THEN 300 
60 IF Af<>"D" THEN 30 
90 TRAP 90 

100 ? =? "ENTER A DECIMAL NUMBER FROM 0 
THFlOUGH 9999999999." 

110 ? "DEC:";:iHPUT N 

120 IF N<0 OR N>=1E+10 THEN GOTO 100 

130 1=9 

140 TEMP=N:N=INT(N/16) 

150 TEMP=TEMP-NM16 

160 IF TEMP<10 THEN A$( LI)=STRI<TEMP) = G 
OTO 1S0 

170 A$( I.. I ;:'=CHRf( T£MP-10 +h3C( "A")) 

180 IF NO0 THEN 1=1-1 ^GOTO 148 
190 ? "HEM: '•;AI<L9):? 

2'00 GOTO 110 
300 TRAP 380 

310 ? :? "ENTER A HEM NLTIBER FROM Q THRO 
UGH FFFFFFFF." 

320 ? "HEM:";:INPUT 
330 N=0 

340 FOR 1=1 TO LEN<AI) 

345 ADf=Af<I..I):IF AD$<"0" THEN 380 
350 IF A$(LI>(="9" THEN N=N:^16+UAL(ADJ) 
:GOTO 370 

355 IF ADI<"A" THEN 388 

357 IF ADf>"F" THEN 388 

360 N=N«16+ASCC ADI)-A3C("A">+18 

370 NEMT I 

380 ? "DEC: ";N:? 

390 GOTO 320 
408 END 
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APPENDIX I 


MEMORY 

LOCATIONS 


Note: Many of these locations are of primary interest to expert programmers and are included here as a 
convenience. The labels given are used by Atari programmers to make programs more readable. 



DECIMAL 

HEXADECIMAL 

LABEL 

LOCATION 

LOCATION 

APPMHI 

14,15 

DE 

RTCLOK 

18,19,20 

12,13,14 

SOUNDR 

65 

41 


77 


LMARGIN, 

RMARGIN 

82,83 

52,53 

ROWCRS 

84 

54 

COLCRS 

85,86 

55,56 

OLDROW 

90 

5A 

OLDCOL 

91,92 

5B 


93 

5C 

NEWROW 

96 

60 

NEWCOL 

97,98 

61,62 

RAMTOP 

106 

6A 

LOMEM 

128,129 

80,81 

MEMTOP 

144,145 

90,91 

STOPLN 

186,187 

BA,BB 

ERRSAV 

195 

C3 

PTABW 

201 

C9 

FRO 

212,213 

D4,D5 


COMMENTS AND DESCRIPTION 

Highest location used by BASIC (LSB, MSB) 

TV frame counter (1/60 sec.) (LSB, NSB, MSB) 
Noisy I/O Flag (0 = quiet) 

Attract Mode Flag (128 = Attract mode) 

Left, Right Margin (Defaults 2, 39) 

Current cursor row (graphics window). 

Current cursor column (graphics window). 

Previous cursor row (graphics window). 

Previous cursor column (graphics window). 

Data under cursor (graphics window unless mode 

0 ). 

Cursor row to which DRAWTO will go. 

Cursor column to which DRAWTO goes. 

Actual top of memory (number of pages). 

BASIC low memory pointer. 

BASIC top of memory pointer. 

Line number at which STOP or TRAP occurred 
(2-byte binary number). 

Error number. 

Print tab width (defaults to 10) 

Low and high bytes of value to be returned to 
BASIC from USR function. 
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DECIMAL 

HEXADECIMAL 

LABEL 

LOCATION 

LOCATION 

RADFLG 

251 

FB 

LPENH 

564 

234 

LPENV 

565 

235 

TXTROW 

656 

290 

TXTCOL 

657,658 

291,292 

COLORO 

708 

2C4 

COLORl 

709 

2C5 

COLOR2 

710 

2C6 

COLOR3 

711 

2C7 

COLOR4 

712 

2C8 

MEMTOP 

741,742 

2E5,2EG 

MEMLO 

743,744 

2E7,2E8 

CRSINH 

752 

2F0 

CHACT 

755 

2F3 

CHBAS 

756 

2F4 

ATACHR 

763 

2FB 

CH 

764 

2FC 

FILDAT 

765 

2FD 

DSPFLG 

766 

2FE 

SSFLAG 

767 

2FF 

HATABS 

794 

31A 

lOCB 

832 

340 


1664-1791 

680-6FE 

CONSOL 

53279 

DO IF 


• Future product. 


COMMENTS AND DESCRIPTIONS 

RAD/DEG flag (0 = radians, G = degrees). 

Light Pen* Horizontal value. 

Light Pen* Vertical value. 

Cursor row (text window) 

Cursor column (text window) 

Color Register 0 
Color Register 1 
Color Register 2 
Color Register 3 
Color Register 4 

OS top of available user memory pointer (LSB, 
MSB) 

OS low memory pointer 

Cursor inhibit (0 = cursor on, 1 = cursor off) 

Character mode register (4 = vertical reflect; 2 = 
normal; 1= blank) 

Character base register (defaults to 224) (224 = up¬ 
per case, 22G = lower case characters) 

Last ATASCII character. 

Last keyboard key pressed; internal code; (255 
clears character). 

Fill data for graphics Fill (XIO). 

Display Flag (1 = display control character). 

Start/Stop flag for paging (0 = normal listing) Set by 

Handler address table (3 bytes/handler) 

I/O control blocks (16 bytes/IOCB) 

Spare RAM 

Console switches (bit 2 = Option; bit 1 = Select; bit 
0 = Start. POKE 53279, 0 before reading. 0 = 
switch pressed.) 
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DECIMAL 

HEXADECIMAL 


LABEL 

LOCATION 

LOCATION 

COMMENTS AND DESCRIPTIONS 

PORTA 

54016 

D300 

PIA Port A Controller Jack I/O ports. 

PORTB 

54017 

D301 

PIA Port B Initialized to hex 3C. 

PACTL 

54018 

D302 

Port A Control Register (on Program Recorder 52 
= ON, 60 = OFF). 

PBCTL 

54019 

D303 

Port B control register. 

SKCTL 

53775 

D20F 

Serial Port control register. Bit 2 = 0 (last key still 
pressed). 
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Notes 



INDEX 


A Abbreviations, 4-5 

Commands in headings, 4 
ABS, 33 
adata, 5 
ADR, 35,63 
aexp, 4 
aop, 4 

Array, 3-4, 41 
ASC, 37 

ATASCII, 5, 40, C-1 through C-6 
ATN, 34 

Audio track of cassette, 23 
avar, 4 

B BASIC, 1 

Blanks {see Spaces) 

Booting DOS, 25 
Braces, 4 
Brackets, 4 
Branching, 

Conditional Statements, 19 
Unconditional Statements, 17 
Brightness (see Luminance) 

Bubble Sort Program, H-5 
Buzzer, 14 
Deferred Mode, F-1 
Direct Mode, 14 
BYE, 9 

C C-Scale Program, 58 

Central Input/Output Subsystem, 23 
Character 

Assigning Color to, 54 
ATASCII, C-1 through C-6 
Display at specified locations, 46, 47 
Set, internal, 55 
Sizes in Text modes, 46 
Chaining Programs, 30 

Checkbook Balancer Program, H-1 through H-4 
CHR$, 58 

CIO (see Central Input/Output Subsystem) 6 
CLEAR key, 6 
Clear Screen, 

Deferred mode, 5, 14, 46 
Direct mode, 6, 46 
CLOAD, 24 
CLOG, 33 
CLOSE, 27 
CLR, 43 
Codes, 

Device, 23-24 
Colons, 3, 61 
COLOR, 48 


Color 

Assigning, 54 
Changing, 50 
Default, 46, 51 
Registers, 50 
COM (see DIM) 

Computer Blues Program, H-16 
cmdno, 30 
Comma, 26, 27 
Command Strings, 1 
Commands 
BYE, 9 
CONT, 9 
END, 9 
LET, 10 
LIST, 10 
NEW, 10 
REM, 10 
RUN, 11 
STOP, 11 
Conservation, 

Memory, 61 
Constant, 2 
CONT, 9 
Controllers, 

Game, 59 
COS, 34 
CSAVE, 24 
Cursor, 9 
Graphics, 49 
Inhibit, 46 

D Decimal/Hexadecimal Conversion Program, H-18 
Default 
colors, 46 
disk drive, 24, 29 
margins in Mode 0, 46 
tab settings, 6 
Deferred mode, 5 
DEG, 35 
Devices, 23-24 
Delete line, 13 
DIM, 41 
Direct mode, 5 
Disk Drive 

Default number, 24, 29 
Requirements (see ATARI DOS Manual) 

Disk file 

Modification of BASIC program, 31 
Display, split-screen override, 45, 47 
Distortion, 57 
DOS, 25 
DRAWTO, 48 
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E Editing, screen, 13 
Editor, Screen, 24 
END, 9 

before subroutine, 7 
End of file, 14 

Error messages, B-1 through B-3 
Escape key, 5 

with Control Graphics Symbols, F-1 
EXP, 33 
exp, 5 

Exponentiation symbol, 6 
Expression, 1 
Arithmetic {see aexp) 

Logical (see lexp) 

String (see sexp) 

F filename, breakdown, 27 
filespec, 5 
Usage, 26, 27 
Fill (XIO), 54 
FOR/NEXT, 15 

building arrays and matrices, 42 
with STEP, 15 
without STEP, 15 
FRE, 35 
Function, 1 
Arithmetic 
ABS, 33 
CLOG, 33 
EXP, 33 
INT, 33 
LOG, 34 
RND, 34 
SGN, 34 
SQR, 34 
Built-in, 7 
Derived, E-1 
Library, 33 
Special Pui'pose, 35 
ADR, 35 
FRE, 35 
PEEK,35 
POKE. 35 
USR, 36 

Trigonometric, 34 
ATN, 34 
COS, 34 
DEG, 35 
RAD, 35 
SIN, 35 

G Game controllers 
Keyboard, 59 
Joystick, 59 
Paddle, 59 

Video Graffitti program, H-12 through H-13 
Game controller commands 
PADDLE, 59 
PTRIG, 59 
STICK, 59 
STRIG, 60 
GET, 28, 49 

GOSUB/RETURN, 16, 21 


GOTO, 17 

with conditional branching, 17 
GRAPHICS, 45 
Graphics 
Modes, 46-47 
Statements, 48 
COLOR, 48 
DRAWTO, 49 
GET, 45 
GRAPHICS, 48 
LOCATE, 48 
PLOT, 49 
POSITION, 49 
PUT, 49 
SETCOLOR, 50 
XIO (Fill), 54 

Graphics Control Characters, 56 

H Harmony, 57 
Hexadecimal 

/Decimal Conversion Program, H-18 
Hexcode Loader program, 64 

I INPUT, 25 

Input/Output Commands, 23 
CLOAD, 24 
CLOSE, 27 
CSAVE, 24 
DATA, 28 
DOS, 25 
ENTER, 25 
GET, 28 
INPUT, 25 
LOAD, 26 
LPRINT, 26 
NOTE, 26 
OPEN, 26 
POINT, 28 
PRINT, 3, 5, 14, 26 
PUT, 28 
READ, 28 
SAVE, 29 
STATUS, 29 
XIO, 29 

Input/Output Devices 
Disk Drives (D:), 24 
Keyboard (K:), 23 
Line Printer (L:), 23 
Program Recorder (C:), 23 
RS-232 Interface (R;), 24 
Screen Editor (E:), 24 
TV Monitor (S:), 24 
INT, 33 

Infernal pointer for DATA, 21 
Input/Output Control Block, 23 
Inverse Key, 5 

Invisible graphics cursor, 48-49 
lOCB (see Input/Output Control Block) 

J Joystick Controller, 59 

K. Keyboard (K:), 23 

Keyboard Controllers, 59 
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Keyboard Controller Program, H-14 
Keys 

Special Function 
ATARI, 5 
BACK SPACE, e 
BREAK, 6 
CAPS/LOWR, 5 
CLEAR, 6 
DELETE, 6 
ESCAPE, 5 
INSERT, 6 
RETURN, 6 
SYSTEM RESET, 6 
TAB, 6 
Editing 

CTRL (Control) Key, 13 
SHIFT key, 13 
Cursor Control, 14 
Down arrow, 14 
Left arrow, 14 
Right arrow, 14 
Up arrow, 14 
Keywords 

BASIC, A-1 through A-5 

L LEN, 38 

LET, 2, 3, 10 
Letters 

Capital (upper case), 3 
Lower case, 3, 47 
Icxp, 4 

Light Show Program, H-8 
Line 

Format, 3 
Logical, 2 
Numbers, 3 
Physical, 2 
lineno, 5 
LIST, 10 
LOAD, 26 

Load program from cassette tape, 24 
LOCATE, 48 
LOG, 34 
Loops 
Endless, 17 
Nested, 15 
lop, 4 

LPRINT, 26 
before CSAVE, 24 
Luminance, 50 

M Mandatory it symbol, 26, 27 
Margins 

Changing, 36, 46 
Default in mode 0, 46 
Matrix, 41-42 
Variable, 4 

Memory Map, D-1 through D-2 
Modes, graphics, 46, 47 
Modes, operating 
Deferred, 5 
Direct, 5 
Execute, 5 
Memo Pad, 5, 25 


Modes, text, 46 
Override split-screen, 47 
Multiple commands {see 
Command Strings) 
mvar, 4 

N NEW, 10 
Notations 
floating point, 39 
in manual, 3 

O ON/GOSUB, 20 
ON/GOTO, 20 
OPEN, 26-28 
Operators, 2 
Arithmetic, 4, 6 
Binary, 6, 7 
Logical, 4, 6 
Relational, 7 
Unary, 6 

Output devices, 23 

Oversized programs (see Chaining Programs) 

P Paddle Controller, 59 
Parentheses, 

Usage, 7, 63 
PEEK,35 

Peripheral devices [see Input/Output Devices) 
Pitch 

Definition, 57 
Values, 58 
Pixel, 48 

Size in modes, 47 
PLA, 63 
PLOT, 49 
POINT, 28 
POKE, 35 
POP, 20-21 
POSITION, 49 
Precedence, operator, 7 
PRINT, 3, 5, 14, 26 
Printer listing, 10 
Program continuation, 11 
Programs, 

Machine language, 67 
User, Appendix H 
with Hexcode Loader, 65, 66 
PUT, 49 

Q Question mark as prompt, 25 
Quotation marks, 2 

R RAD, 35 

RAM (Random Access Memory), 23 
Random Access to disk file, 28 
READ, 28 
Direct mode, 28 
REM, 10 
RESTORE, 21 
RETURN Key, 6 
Return, Abnormal (see POP) 

Rollover, 

Keyboard, 8 
RND, 34 
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RS-232(R:), 24 
RTS, 63 
RUN, 11 

S SAVE, 29 

Save programs on cassette tape, 24 
Screen Display (see TV Monitor) 
Screen Editor (E:), 24 
Seagull Over Ocean Program, H-11 
Semicolon, 28 
SETCOLOR, 50-53 
sexp, 5 
SON, 34 
SIN, 35 
SOUND, 57 
terminating, 9, 57 
Spaces, 61 
SQR, 34 
Stack, 16 
GOSUB, 16 
Hardware, 36 
loop addresses, 16, 21 
POP, 20 
Statement, 

Program, 15 
FOR, 15 
GOSUB, 16, 21 
GOTO, 17 
IF, 18 

ON/GOSUB, 20 
ON/GOTO, 20 
POP, 20 
RESTORE, 21 
RETURN,16 
STEP, 15 
THEN, 18 
TO, 15 
TRAP, 22 
STEP, 15 
STOP, 11 
String 

Comparison, 40 
Concatenation, 39 
Dimensioning, 37 
Functions 
ASC, 37 
CHR$, 37 
LEN, 38 
STR$, 38 
VAL, 38 
Manipulation, 39 
Sort, 40 
Splitting, 39 
Variable, 4 
STR$, 38 
Subroutine 
Definition, 16 
GOSUB, 16 
Usage, 16 
svar, 4 

T Terminology, 1 
Text modes, 46 


Text Modes Characters Program, H-7 
Tokenized version, 3, 24 
Tone, clipped, 57 
TRAP, 22 

Type-A-Tune Program, H-15 
u Untokenized version, 3 

V var, 4 
Variable, 2 

avoiding name limit, 2 
Video Graffitti Program, H-12 
Volume control, 57 
Voice, 57 

W Window 

Graphics, 47 
Text, 47 
Wraparound, 8 

X X-coordinate, 47 
XIO, 29 
XIO (Fill). 54 

Y Y-coordinate, 47 
Z Zero 

as Dummy Variable, 30, 34 
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ERROR CODES 


ERROR 

CODE ERROR CODE MESSAGE 

2 Memory Insufficient 

3 Value Error 

4 Too Many Variables 

5 String Length Error 

6 Out of Data Error 

7 Number greater than 32767 

8 Input Statement Error 

9 Array or String DIM Error 

10 Argument Stack Overflow 

11 Floating Point Overflow/ 

Underflow Error 

12 Line Not Found 

13 No Matching FOR Statement 

14 Line Too Long Error 

13 GOSUB or FOR Line Deleted 

16 RETURN Error 

17 Garbage Error 

18 Invalid String Character 

Note: The following arc INPUT/OUTPUT er¬ 
rors that result during the use of disk drives, 
printers, or other accessory devices. Further in¬ 
formation is provided with the auxiliary hard¬ 
ware. 

19 LOAD program Too Long 

20 Device Number Larger 

21 LOAD File Error 

128 BREAK Abort 

129 lOCB 

130 Nonexistent Device 

131 lOCB Write Only 

132 Invalid Command 

133 Device or File not Open 

134 BAD lOCB Number 

135 lOCB Read Only Error 

136 EOF 

137 Truncated Record 

138 Device Timeout 

139 Devdee NAK 

140 Serial Bus 

141 Cursor Out of Range 


ERROR 

CODE ERROR CODE MESSAGE 

142 Serial Bus Data Frame Overrun 

143 Serial bus data frame checksum error 

144 Device done error 

145 Read after write compare error 

146 Function not implemented 

147 Insufficient RAM 

160 Drive number error 

161 Too many OPEN files 

162 Disk full 

163 Unrecoverable system data I/O error 

164 F’ile number mismatch 

165 File name error 

166 POINT data length error 

167 File locked 

168 Command invalid 

169 Directory full 

170 File not found 

171 POINT invalid 


For explanation of Error Messages see Appendix B. 







